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A Versatile 
Computer System 


The IBM PCjr can be the core of many different 
computer systems, each designed fora completely 
different application. An artist might use the PCjr's 
calor and graphics features to create original im¬ 
ages or to manipulate existing ones by removing 
lines, altering colors and rotating shapes. In a 
small office, a PCjr could be used to calculate ac¬ 
counts and keep financial records or to do word 
processing and maintain correspondence files. At 
home, you could use it to keep budgets, to main¬ 
tain household records, to communicate with other 
computer users or to play games. 

The reason the computer can do all these jobs is 
that it is designed to control a multitude of acces¬ 
sories used for specialized applications. Most of 
these accessories, called peripheral components, 
are made by IBM, but many more will be produced 
by other manufacturers for use with the IBM PCjr. 

If you plan to use your PCjr for relatively modest 


operations, you can buy the basic entry-level mod¬ 
el— a package containing a system unit, a cord¬ 
less keyboard and an electrical transformer — and 
add peripherals as you need them. More complex 
operations, such as word processing, require the 
disk drive and 128K memory of the expanded PCjr 
system. The PCjr is designed to grow with your 
needs, simply through the addition of peripherals. 

The expanded system shown here includes the 
components needed for the most common uses of 
the PCjr — word processing, budgeting, display of 
color graphics, games, information storage and 
retrieval, and the printing out of results. Your sys¬ 
tem may include some or all of these components, 
and others chosen to meet your particular needs. 
This manual will show you the basic principles of 
operating the IBM PCjr system and will explore 
some of the ways the computer can be adapted tor 
specialized applications. 
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The PCjr’s Parts: An Anatomy Lesson 


A printer produces a paper record of the 
computer's work. The standard IBM Com¬ 
pact Printer shown here produces rough 
but clear type on heat-sensitive paper; more 
specialized printers produce fine-quality 
print or color graphics. 


Sheets of 8y2-by-l 1 -inch fan- 
fold thermal paper are connected 
at the top and bottom by rows 
of perforations. A spring-clip re¬ 
lease lever on the printer locks 
the paper in place for continuous 
feed. Single sheets and roll pa¬ 
per are also available. 




Cartridges and floppy disks contain com¬ 
puter programs or information. Floppy disks 
are also used to store information. 



A joystick controls the computer for 
games. Usually joysticks are connected in 
pairs, so that more than one person can 
play a game at one time. 
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Using the household color television set to 
display work helps keep the cost of o system 
low. A color TV is usually adequate for 
games and educational programs. 



A color video monitor is best suited for uses where color and flexibility are im¬ 
portant, as in the preparation of charts, maps and games. Text lines displayed on 
the screen may be either 40 or 80 characters long. 
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An audio box, or external speaker, pro¬ 
vides sound transmission when the 
PCjr is used with a monitor that has no 
speaker; when attached to a TV, the 
PCjr uses the set's sound system. 


An electrical transformer 
converts 110-volt alternating 
current into the low-voltage 
direct current used by the PCjr. 
The system draws up to 33 
watts of power. 



The system unit is the heart of the com¬ 
puter system, housing the electronic cir¬ 
cuits that process and store informa¬ 
tion. The workings of all the other parts of 
the system are controlled by this unit. 



The keyboard is the device most commonly used to transfer information into the 
computer. Instructions typed on the keyboard can direct the computer to per¬ 
form an enormous range of tasks. The PCjr's cordless keyboard communicates 
by infrared signals to the system unit; an optional cord is available. 
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The Hardware: 
Set-up to Start-up 


When you unwrap your PCjr, it will be nearly ready to 
use. All you have to do Is unpack the connponents, set 
them up, connect them with cables and turn them on. To 
do the job, you will need nothing more than a screwdriver 
and about half an hour of time. 

Set up the system where you will be comfortable using 
it. Pick a place away from direct sunlight and heat: The 
computer needs to stay cool, and you need to avoid 
annoying glare on the monitor screen. Although you may 
sometimes want to work with the PCjr's unattached key¬ 
board on your lap, you should still provide yourself with a 
table that is of a convenient height for typing and is large 
enough — at least 30 by 36 inches — to hold the system 
components, papers and a lamp. For your IBM manuals 
and other reference books, nearby shelves are useful. 

The system components are packed in separate com¬ 
partments of one box, and they are protected by plastic 
bags and special foam Inserts that prevent the build¬ 
up of static electricity, which could wreak havoc with 
the electronics of the system. Be sure to save all of 
these packing materials; you will need them to protect 
the equipment anytime you move it. And go carefully 


through the carton before you store it, making certain 
you have removed all printed matter. 

The inside of each component is a marvel of electronic 
and mechanical complexity, but you don't need to know 
how a computer works before you start using It. Your 
PCjr already has the necessary connections for such op¬ 
tional equipment as a monitor, printer or game control¬ 
lers. For the adapters these components may require, 
consult your dealer. And remember your dealer in case 
anything goes wrong as you set up the system; that's the 
reason you have a warranty. If anything doesn't work, 
retrace your steps and try again. If it still doesn't work, 
call the dealer. 

The expanded PCjr system shown In this chapter In¬ 
cludes a printer and an IBM RGB (color) monitor, in addi¬ 
tion to the system unit with cordless remote keyboard, 
one disk drive and two cartridge slots. More specialized 
components such as communications devices and game 
attachments are discussed In later chapters. Whenever 
you have questions about installations, or hardware In 
general, you will find the IBM Guide to Operations — 
packaged with the computer — a useful reference. 


Fresh from the box, on IBM PCjr keyboard 
sits atop its system unit. Weighing less than 
two pounds, this battery-operated key¬ 
board can be held on your lap and operated' 
with no cables attached. It sends signals 
to the system unit from up to 20 feet away, by 
means of infrared rays; you need only 
keep the back of the keyboard aimed roughly 
at the front of the computer. 
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THE HARDWARE 



The system unit of the enhanced IBM PCjr, shown here schemati¬ 
cally, hauses the main processing and memory circuits, as well as the 
disk drive and the expansion board. The central processing unit, or 
CPU, which lies beneath the disk drive, processes and distributes in- 
formatian; memory stores it during processing, and the disk drive 
records it on floppy disks. The expansion board increases the PCjr's 
memory and allows display of 80 characters of text on each line. 


The system unit is the control center 
of the IBM PCjr. Inside this box ore 
the circuits and mechanisms that 
process and store information and 
that send instructions to other parts 
of the system. 

The computer is said to read when 
it takes information in, and to write 
when it sends information out. Much 
of the information passes to and 
from the computer's memory, which 
is housed in a set of specialized cir¬ 
cuits. One part, called read-only 
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memory (ROM), holds a permanent 
record of information the computer 
needs each time it is turned on. ROM 
cannot be added to or erased. An¬ 
other part, the read-and-write, or 
random access, memory (RAM), lets 
the computer store and retrieve in¬ 
formation. You can erase the con¬ 
tents of read-and-write memory to 
make room for new information; in 
fact, whenever the unit is switched 
off, RAM is wiped clean. For more 
permanent storage, the computer 


can also read and write information 
on floppy disks, which are inserted in 
the system unit's disk drive, or on 
magnetic tape. 

A transformer, called the power 
supply, converts the household's 
1 lO-volt alternating current into the 
low-voltage direct current required 
by the PCjr's circuits. The power sup¬ 
ply heats up when plugged in, so it is 
wise to unplug it from the outlet if you 
are not going to be using your com¬ 
puter for a few days. 


























The horizontal opening of the disk drive, 
located on the front of the system unit, may 
hold a protective cardboard insert when 
you unpack your system. You must remove 
the insert before operating the system; 
turn the latch at the left side of the opening 
and pull the cardboard out. 



The back of the system unit has 13 
input/output slots for cables that link the unit 
with other parts of the system. The power 
supply slot, labeled P, is at the right side of 
the back. Before you insert the rectangular 
plug of the power-supply cable into the sys¬ 
tem unit, make sure the switch above the con¬ 
nection is in the OFF position. Don't plug the 
other end of the power-supply cable into an 
outlet until you have connected the rest of the 
components to the system unit. 
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BPPro^ay Monitor ^ 
Composite Video 


The PCjr’s 
Two Models 


There ore two versions of the IBM 
PCjr — the entry model and the en¬ 
hanced model. The entry model is 
the simpler and less expensive of 
the two. But there are significant 
similarities. The two models use 


identical keyboards, and both 
have two slots in the system unit for 
cartridges containing software. 
Each version has 64,000 bytes of 
read-only memory (a byte is the 
unit of memory required to store a 
single character). 

In other respects, however, the 
enhanced version is a more pow¬ 
erful and more versatile machine. It 
has 128,000 bytes of read-and- 
write memory, compared with the 


64,000 of the entry model. The en¬ 
try model lacks a built-in disk drive, 
relying instead on a cassette re¬ 
corder for saving information. 
Each model can be used with ei¬ 
ther a home TV set or a monitor as 
a display device, but the entry 
model can display text only in the 
40-column mode. You can add ac¬ 
cessories to an entry-level ma¬ 
chine to increase its usefulness; 
see pages 98-99. 
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THE HARDWARE 

The Keyboard; Your Connection to the PCjr 


The IBM PCjr's keyboard resembles a 
typewriter's, except that it has additional 
keys. Keyboard input can be transmitted 
to the system unit either over a cable or by in¬ 
frared signals emitted by diodes on the 
back of the keyboard. No matter which meth¬ 
od of transmission you choose, you can 
use the keyboard in your lap or on a table. 



When you are planning to rely on infrared 
signals for data transmission, turn the key¬ 
board over and insert four AA alkaline bat¬ 
teries in the compartment on the bottom 
to provide power for the keyboard. To adjust 
the angle of the keyboard for tabletop 
use, fold out the two small plastic legs on the 
bottom of the keyboard. 



The keyboard is the PCjr's main de¬ 
vice for sending information to the 
computer. It looks like the front half of 
a typewriter with 62 keys, but striking 
a key yields a different kind of result. 
Instead of producing a symbol on a 
piece of paper, a keystroke sends a 
signal to the computer, where it is 
processed by the CPU. 

The keyboard has no ON/OFF 
switch. When not in use, it draws a 
negligible amount of current from its 
four AA batteries. But at the press of 
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a key, the keyboard is.immediately 
activated; it steps up the amount of 
current it draws and begins sending 
signals. When keystrokes cease, the 
keyboard becomes dormant again. 

The computer's keyboard sends 
signals in one of two ways. On its 
back panel are two bulbs, known as 
light-emitting diodes (LEDs), that 
transmit signals via infrared light to 
the system unit. A photo-electric cell, 
which can be seen through a small 
opening on the front of the system 


unit, receives the infrared signals. 
Keyboard signals can also be 
transmitted to the system unit over a 
cable. You will need to use a cable 
set-up if strong sunlight disrupts re¬ 
ception of infrored signals, or If two 
IBM PCjrs operating in the same 
room interfere with each other's in¬ 
frared signals. When you use the ca¬ 
ble, the keyboard's batteries and 
LEDs automatically shut down and 
power is drawn from the system unit 
to run the keyboard. 























V 



To link the computer keyboard to the system unit with the coble, be 
sure that the unit's power switch is in the OFF position and unplug the 
power supply from the outlet bar or wall outlet. Push the coble ter¬ 
minal marked K, with the /Cfacing up, into the connector labeled /Con 


the back of the system unit. Push the cable's other terminal, tab 
side down, into the connector on the right end of the keyboard's back 
panel. In addition to transmitting input, the cable supplies current 
to the keyboard for its operation. 



Positioning for the 
Infrared Link 


When you are relying on infrared 
signals for the transmission of in¬ 
put from the keyboard to the sys¬ 
tem unit, careful positioning is im¬ 
portant. Even though the two 
components can be separated by 
as much as 20 feet, the back of the 
keyboard must still be oriented to¬ 
ward the front of the system unit. 
The two components do not need 


to be parallel or in precisely the 
same plane: The keyboard can be 
positioned to aim its signal any¬ 
where within arcs of 60 degrees 
up or down from, or to the left or 
right of, dead center. Make sure 
that no solid object, such as a 
chair, lies in the line of transmis¬ 
sion, since the infrared signals will 
not be able to penetrate it. 


When a keyboard is out of 
range, or Its signal is blocked or 
scrambled by too much direct 
sunlight, or If its signal power is re¬ 
duced because of weak batteries, 
it will emit a beep to alert you to 
the faulty link. 
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THE HARDWARE 


Video Display: 
Several Options 


An RGB monitor delivers high-intensity, 
high-resolution signals, an important factor if 
you plan to use software with detailed 
graphics. It displays an 80-character line, 
double that of most other color monitors. 
Some games software, however, will not dis¬ 
play in color on RGB monitors. 



To connect the PCjr to an RGB monitor, 
turn off and unplug both units, then plug the 
end of the adapter cable marked D, label 
up, into the D connector on the back of the 
system unit. Insert the other end into the 
free end of the RGB monitor signal cable. 
Tighten the screws on either side of the 
connectors. Plug the color monitor's outlet 
cord into an electrical outlet. 



Adapter Cable 


Signal Cable 


With a color monitor or color televi¬ 
sion set attached to your PCjr, the 
door to visually exciting software is 
wide open. If you decide to use your 
color television, you will need an RF 
(radio frequency) modulator, to 
change the computer signals to a 
form the TV can accept. Using a tele¬ 
vision as a monitor, you can write 
lines 40 characters long and display 
graphics in color, but the color qual¬ 
ity will depend on the quality of your 
set. With some television screens, let¬ 
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ters can be very difficult to read. 

For better clarity and color intensi¬ 
ty, you might choose between two 
types of color monitor, the compos¬ 
ite video and the RGB monitor. A 
composite-video monitor uses a sin¬ 
gle signal to control the three color 
'"guns" behind the screen, the same 
as a televison but with a higher res¬ 
olution of color. Composite-video 
monitors use a single-pin phono 
jack. With the RGB (for red, green 
and blue), the computer sends a 


separate signal for each of the three 
colors, providing the greatest resolu¬ 
tion and intensity. In addition, the 
screen accommodates lines 80 char¬ 
acters long, an advantage if you 
plan to use the computer as a word 
processor. An IBM adapter cable is 
necessary to link the RGB monitor 
with the PCjr. 































Linking the PCjr 
to Your Television Set 


To connect a TV set to the PCjr, turn both off and unplug them from 
household current. Plug the cord marked Ton the IBM Connector for 
Television into the socket labeled T on the back of the system unit; 
the Ton the IBM connector's plug must face up. With a screwdriver, 
loosen the screws labeled VHP on the back of the TV set to free the 
twin leads of the VHP antenna. Slip these antenna leads under the two 
screws on the side of the IBM connector; tighten the screws. 


An antenna wire labeled TO tv receiver vhf terminal extends from 
one end of the IBM Connector for Television. Slip the twin leads of the 
antenna wire under the television set's VHP screws; use a Phillips 
screwdriver to tighten the screws (above). 




To use the TV set for computer display, set the IBM connector's 
channel-select switch for channel 4 or channel 3, whichever one is not 
broadcast in your area, set the switch on the connector's face on 
COMPUTER, and turn the PCjr on. To return to television viewing, set the 
switch on the IBM connector's face to TELEVISION. 
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THE HARDWARE 


Setting Up the 
Thermal Printer 


Once the printer is plugged in and turned 
on (the ready signal light will glow), pull the 
paper-release lever forward and, with the 
plastic access cover closed, insert the leading 
edge of a stack of fanfold paper through 
the slot in the top of the cover. Push the paper 
into the paper path until it stops. Lock it 
in place by returning the paper-release lever 
to its original position. 



Press and hold down the paper-feed but¬ 
ton to advance the paper. Stop when the pa¬ 
per is positioned properly for your first 
line. To be certain that paper is correctly 
loaded and the printer is operating, run 
a printer self-test. Switch off the power and 
press and hold down the paper feed; 
switch the power on and when the machine 
starts printing lines of letters, numbers and 
symbols, release the feed button. Stop the 
test by turning off the machine. 



With the power switches of both printer 
and computer turned off, plug the printer ca¬ 
ble into the serial port, which is labeled 5, 
at the rear of the computer. Before using the 
printer, turn on the power first to the com¬ 
puter, then to the printer. 
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Parallel Port; Gateway to Expansion 


The Compact Printer isn't the only 
printer you con attach to the PCjr's 
serial port. With an adapter cable, 
you can use letter-quality or daisy- 
wheel printers that produce type 
like that from a typewriter. 

However, if speed and flexibility 
are more important to you, you 
may decide on a dot-matrix printer. 


Dot-matrix printers print each char¬ 
acter as a set of dots, and use stan¬ 
dard fanfold paper; some can also 
print on single sheets. They are very 
fast, printing 80 ta 300 characters 
per second, or about 960 to 3,600 
words per minute. Some parallel 
printers are also designed to print 
graphics as well as characters. You 


may even want a color printer. I 
A dot-matrix or color printer must 
be connected via the optional Par¬ 
allel Printer Attachment. Remove 
the PCjr's right side panel (below), 
secure the attachment in place, and 
cover it with the side panel. A cable 
from the printer then plugs into the 
rear of the attachment. 


To remove the access panel on the system unit, first turn off the unit 
and unplug the power cord. Grip the slot at the base of the 
panel on the right side and pull the panel off. You may need to pry 
it gently with a nonmagnetized flathead screwdriver. 


Hold the Parallel Printer Attachment so as to align its mounting pins 
with mounting holes on the side of the system unit, and to align 
the attachment connector with the parallel-port slot. Press the at¬ 
tachment into place and tighten the screws. Affix the access 
panel to the attachment by snapping it into place. 


By connecting a printer to the PCjr, 
you con preserve the work of your 
computer, a convenience in many in¬ 
stances and essential to utilizing the 
PCjr's word processing capabilities. 

The IBM printer designed as a 
companion to the PCjr is the 
lightweight (less than seven pounds), 
low-cost Compact Printer. Rather 
than imprinting ink on paper, the 
Compact Printer uses hundreds of 
tiny heated pins to burn impressions 
onto thermal paper. The printer can 


reproduce anything visible on the 
monitor, including graphics, and 
characters In three type sizes. 

Thermal paper Is available In sin¬ 
gle sheets, in a roll that fits Into the 
printer, or in fanfold, a length of fold¬ 
ed, perforated paper that sits behind 
or below the printer and feeds into it. 

Yet the Compact Printer has Its 
drawbacks. Thermal paper darkens 
with age or exposure to sunlight, so 
the information printed on it will 
eventually be lost. It prints in only one 


direction, from left to right, and at a 
rate of about 50 characters per sec¬ 
ond, which is slower than many other 
printers. And while the characters 
are legible, they do not have the look 
of letter-quality printers. 

If these are critical considerations 
for your needs, you can connect oth¬ 
er printer models to the PCjr's serial 
port by usinq an optional adapter 
cable or by affixing to the computer a 
special interface known as a parallel 
printer adapter (above). 
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THE HARDWARE 

Putting It All 
Together as a 
System 


A PCjr used forfamily games and educa¬ 
tion utilizes an entry-level system unit, key¬ 
board, transformer, RF modulator, joy¬ 
stick, TV and outlet bar. Cables shown in red 
carry the electricity for powering each 
component. The transformer converts the 
household's 110-volt alternating current 
to the low-voltage direct current used by the 
computer. Other cables (blue) convey the 
electrical impulses that encode information to 
be processed by the components. 










Linking the components of your PCjr 
is simple. You need only position the 
components conveniently and re¬ 
member a few precautions. 

Place the system unit on a table 
and the keyboard in front of it. See 
that nothing blocks the Infrared sig¬ 
nal that lin.ks the keyboard and the 
system unit. Place the television or 
video monitor where you can com¬ 
fortably see the screen. A TV or moni¬ 
tor should be at least 6 inches from a 
disk drive, however; it can generate 
18 


signals that interfere with the record¬ 
ing of information. 

You can put the printer anywhere 
up off the floor. If you use an outlet 
bar (box, for right) put it on the floor 
near a wall, out of the way of ac¬ 
cidental kicks. 

Be sure not to block any compo¬ 
nent's fan vents. And leave room, 
away from the computer, for such 
things as coffee cups — spills can 
cause extensive damage. 

The cables that link the compo¬ 


nents contain multiple wires. The 
power cables that draw household 
current have three wires and three- 
prong plugs. Data cables, which 
carry data encoded in electrical im¬ 
pulses to the components, have as 
many as 25 wires, and connectors to 
match. These cables can be dam¬ 
aged if bent sharply or pinched. 

If a connector doesn't plug in easi¬ 
ly, turn it over; most have only one 
correct orientation. If it still doesn't fit, 
you may be trying the wrong socket. 






























































For the home office, o fully complemented PCjr includes on enhanced system 
unit with a disk drive, color monitor, audio box, printer, transformer, outlet bar 
and keyboard connected by cable to the system unit. Cables shown here in 
red conduct power; those shown in blue transmit data. 


Picking Your 
Power Source 

The best way to plug in your system 
is with on outlet bar — several out¬ 
lets controlled by one switch (right). 
Get one that has a built-in regula¬ 
tor, which will protect the system 
from power surges. 

Don't get power from just any 


wall outlet: Only grounded (three- 
hole) outlets protect the computer's 
circuits properly. Avoid jury-rigged 
arrangements with extension cords 
or three-way adapters. 

Avoid sharing circuits with large 
appliances such as refrigerators, 
which often drain current when they 
switch on. And don't use the system 
during electrical storms, which can 
cause voltage surges that could 
burn out the computer. 



An outlet bar provides a separate circuit 
for your system. A built-in regulator absorbs 
abnormal surges of electricity, and a sin¬ 
gle switch controls all the outlets. 
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Turning On the Machine 
and Getting Started 


With all its components in place and hooked up, your 
PCjr can go to work as soon as you flick the power 
switch: Contained in the computer's read-only memory 
(ROM) are information and instructions that make it in¬ 
stantly functional. Each time you turn the PCjr on, it per¬ 
forms a wake-up routine called the power-up self-test, a 
brief automatic program that checks out the system and 
any IBM attachments. While this test is running, the IBM 
logo and color bar appear on the monitor (left). 

At your command, another set of instructions, the di¬ 
agnostic routines (pages 24-25), can direct the machine 
to conduct a more extensive test of all components. There 
is also a built-in tutorial called Keyboard Adventure, 
which you can call up for an introduction to the machine 
and its keyboard (page 23). 

PCjr's keyboard is the primary device for communicat¬ 
ing with the computer and with peripheral components 
such as printers. It resembles the keyboard of a conven¬ 
tional typewriter, with several special keys added. The 
alphabetic, numeric and punctuation keys function much 
as they do on a regular typewriter, but the special keys 
have functions peculiar to a computer. Some of the spe¬ 


cial keys control the movement of the short-flashing 
marker called the cursor. Others instruct the computer to 
enter information in its memory or to erase a character. 
Still others, in combination, are the equivalent of a panic 
button: Pressing them tells the computer to stop whatever 
it is doing and wait for further instructions. 

Also built into PCjr are color, graphics and sound ca¬ 
pabilities. Given the right commands, the machine can 
generate up to 16 foreground and four background col¬ 
ors. From a set of dot patterns, it can create graphics 
on the video screen. It can produce all 12 notes in each 
of the seven octaves of a piano keyboard — including 
sharps and flats. It can also play three-note chords and 
any tempo you select. 

Finally, PCjr comes with a built-in language called BA¬ 
SIC /pages 2d-27y, which you can use to communicate in 
English with the machine. Cartridge BASIC (pages 28- 
29), a more advanced version that you plug into one of 
the machine's cartridge slots, offers more commands 
and capabilities. Learning the language takes practice, 
but once you have mastered it, you will be able to pro¬ 
gram the machine to do your bidding (Chapter 7). 


When the PCjr is up and running, the first im¬ 
age to appear on the monitor is the IBM 
logo and a color bar. The monitor, a cordless 
keyboard and a system unit with disk 
drive and twin cartridge slots form the core of 
an enhanced PCjr system. 
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GEHING STARTED 


Warming Up with 
Keys and Screen 

Turn on the system by switching on first the 
outlet bar and then the individual compo¬ 
nents, leaving the system unit for last. When a 
message like the one at right appears, the 
PCjr is ready for instructions. If the writing is 
off center, hold down the Ctrl and Alt keys 
and use the cursor-control keys (chorf, oppo¬ 
site), to shift the message left or right. 


Keys in the central portion of the keyboard 
behave like their counterparts on a typewrit¬ 
er. Keys marked with a green or blue 
stripe carry out additional tasks when used 
with a corresponding color-coded key: 
Green-coded keys may be used with the 
Function (Fn) key (for right), blue-coded 
keys with the Alternate (Alt) key. 



Esc 1 !2@3 #4 $5%6A7& 


( 0_) ” = + Backspace / Fn 


sygygyygssQBBBisi 


Tab -T QWERTYUI OP[{]} Enter^ 

SDFGHJ KL 



Shift O Z ^ C V B N M . < . > / ?. Shift TT 

B BBQQBBBQQQ B 


Bf 


BB 


Alt 

ISI 


Caps Lock Ins Del 




BBB Bi 


The Control key (Ctrl) changes The space bar deletes characters 

the meanings of other keys when it is as it moves the cursor forward, 

held down as they are pressed. It 
is used for a number of special func¬ 
tions (chart, opposite). 


.The Backspace key (<—) is used 
when you need to make a correction. 
It moves the cursor one space to 
the left, erasing the letter there to 
make room for a new one. 

The Enter key (B) instructs the 
computer to begin processing the 
line of information or instruction 
you have just typed. 


If you operate the PCjr without a disk 
or 0 cartridge, it uses a computer 
language called BASIC, which is 
built into its circuits. When the com¬ 
puter is ready, it writes a message in 
BASIC on the screen (above). The 
message tells you how much mem¬ 
ory is available to process inforitia- 
tion, expressed as the number of 
bytes free. (A byte is a unit of memory 
that holds one character.) The word 
Ok just above the cursor is a prompt 
in BASIC that means the computer is 
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ready for your next command; other 
languages use other prompts. Ig¬ 
nore the line at the bottom of the 
screen for now; it lists some special 
BASIC commands (Chapter/). 

The computer is ready, so explore 
the keyboard. Be fearless: You can't 
hurt the machine by pushing keys. 
Note the difference between the let¬ 
ters /and Oand the numerals / and 
0; the computer will not accept sub¬ 
stitutions. if the message "syntax er¬ 
ror" appears, it simply means the 


computer doesn't understand your 
instructions. Just keep going, if the 
PCjr doesn't react to anything you 
do, turn it off, give it 20 seconds to 
clear its circuits and turn it on again. 

The function of each key on the 
PCjr's keyboard depends on the set 
of instructions, or program, in control 
of the machine. Some programs in¬ 
clude paper overlays to relabel the 
keys; you can also purchase blank 
overlays to assign functions for pro¬ 
grams you write yourself. 





























How Special Keys Function in BASIC 


These four keys, grouped on the right side of the keyboard, move the cursor one space at a time in the 
direction of the arrows. Holding a key down makes the cursor move until the key is released. 

Ctrl -1- Fn/Home 

Holding down Ctrl and pressing Fn and Home clears the screen and puts the cursor in the top left cor¬ 
ner of the screen. 

Ctrl -h Fn/End 

This combination erases characters, from the cursor position to the end of a typed line. All lines on the 
screen are erased until the last Enter is found. 

Ctrl + ^ 

Holding down Ctrl and pressing the -> key moves the cursor to the right until it reaches a new word. 

Ctrl + ^ 

This combination moves the cursor left to the end of the previous word. 

Ins 

Ctrl + R 

These keys are on/off toggles for the insert mode. Pressing Ins alone or Ctrl plus R causes the comput¬ 
er to enlarge the cursor and make room for an insertion to the left of it. Pressing again turns insert off. 

Del 

Ctrl + H ^ 

All three sets of keys delete individual characters. Use Del to erase the character in the cursor position; 
use either Backspace alone or Ctrl and H together to erase the character to the left of the cursor. 

Esc 

Pressing Escape (Esc) erases from the screen all information on the line where the cursor is located. 

Fn -f Break 

By holding down the Fn key while pressing Break, you stop any process the computer is performing. 

The computer then awaits your next instruction. 

Fn Pause 

Pressing Fn and the Pause key puts the computer in a suspended state. These keys temporarily halt 
printing or program listing. To end this state, press any key other than Shift, Ins or Fn/Break. 

Fn + PrtSC 

By holding the Fn key and pressing PrtSc, you instruct the computer to print everything on the screen. 

Be sure the printer is on and ready to print. 

Fn -h Echo 

Pressing Fn and Echo serves as an on/off toggle switch that allows text sent to the screen to be sent to 
the printer at the same time. Pressing both keys again stops the print echo. 


Adventure on 
the Keyboard 


When the message on the screen 
opposite is on your screen, press¬ 
ing the Escape (Esc) key colls up a 
tutorial program — Keyboard Ad¬ 
venture —to help acquaintyou with 
the PCjr's keyboard. (The Adven¬ 


ture is described in your Guide to 
Opera//ons,startingonpage2.)The 
program uses print, graphics, 
sound and a cartoon guide named 
P.C. as learning aids. When you 
press a key, P.C. puts a symbol for 
that key in the appropriate spot on 
the screen keyboard. P.C. also 
demonstrates the functions of spe¬ 
cial keys and key combinations. To 
leave the Adventure, hold down 
Ctrl and Atl and press Del. 
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GETTING STARTED 


Checking the System 
with Built-in Tests 


To clear the PCjr's circuits to begin the di¬ 
agnostic tests, reset the system by holding 
down Ctrl and Alt and pressing Del. 

When the Ok prompt appears, hold down 
Ctrl and Alt and press Ins to call up a Test 
Menu, or set of options Irighf). The icons here 
represent system components to be test¬ 
ed. Press Ins to move the cursor to the Test 
Tag, or character, under the icon you 
want and press Enter to begin the test. Fol¬ 
low along in the Testing chapter of your 
PCjr Guide to Operations. 



To test a monitor with 80-column display, 
select Test Tag 8 and turn to the Guide when 
the screen at right appears. Icon No. 3 
should be blinking. Check the shapes of the 
blocks and figures on your screen against 
those in the Guide to Operations; if any do not 
match, the Guide explains what to do. To 
continue through the 19 remaining screens of 
this test, press Ins to return to the first Test 
Menu, press Fn and then Break. 



Whenever you set up, move or odd 
a component to your PCjr, you 
should run the series of self-tests built 
into the machine's circuits. The tests 
can check only standard IBM com¬ 
ponents, hovyever, so before begin¬ 
ning you should remove all non-IBM 
attachments and cables except the 
display or TV. During the tests you 
vyill need to refer to the Testing chap¬ 
ter in the PCjr Guide to Operations. 

The six icons, or figures, that ap¬ 
pear on the Test Menu screen (top of 
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page) represent peripherals such as 
the keyboard or display, or expan¬ 
sion options such as a light pen or a 
modem. Each icon is labeled by a 
character called a Test Tag. Test 
Tags for options will blink only if the 
option has been installed. 

The test for each component usu¬ 
ally has several parts. Simply com¬ 
pare the shapes and words that ap¬ 
pear on your display with the test 
screens in the Guide (the colors on 
your display may differ from those in 


the booklet). The Guide advises you 
whether you can solve a problem 
yourself or should see a dealer. 

When all parts of one test have 
been completed successfully, an as¬ 
terisk will appear beneath that Test 
Tag and the cursor will blink at the 
next tag. You can choose another 
tag by pressing Ins, to move the cur¬ 
sor, and Enter to start the test. If you 
press Ins when the cursor is on the 
last tag on the first Test Menu, a sec¬ 
ond menu will appear. 
















































The screen at right is called the ASCII 
(pronounced AS-Key) screen. It is the second 
screen that appears in the 80-Column 
Display Test. Check the symbols and pattern 
shown on your screen against the illustra¬ 
tion in the Guide to Operations. The symbols 
represent commands that the PCjr uses in¬ 
ternally to store and communicate charac¬ 
ters; you would not ordinarily see them. 

Press Ins to continue the test. 


ASCII 

O E) cf 9 i” H $ ► ^ 

^ , - . / 0123456789 

: ; < = >?eABCDEFGHIJ 
K L MNOPQRSTUU H X.Y 2 
C \ 3 -^^'abcdefsrhijk 
1 Mnop^rstuv •• x .y z..<_ 

1 H A E aE ft 8 o_b 8 U.y O 

=a a 

— '**' TT -if ® ^ F W K% 

“ap r nS«rpTSOfid«»#(€ n 


The sixth screen to appear during the test 
of an 80-column display reveals three inter¬ 
locking blocks of color IrightJ. Check to 
see that the shapes match those on the corre¬ 
sponding screen in the Guide; it does not 
matter if the colors differ. Press Ins to contin¬ 
ue with the rest of the test. 



The ninth screen in the series displays the 
keyboard characters in vertical bands of col¬ 
or. Compare the shapes of the blocks and 
figures on your screen with those in the Guide 
(again, colors may differ) and press Ins to 
continue. When all the screens of this test 
have run, the first Test Menu screen will re¬ 
appear. You may continue testing other com¬ 
ponents if you wish. To leave the diagnos¬ 
tics mode and reset the system, hold down 
Ctrl and Alt and press Del. 
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GETTING STARTED 


PCjr’s Language: 
a Taste of BASIC 


PRINTING AND CALCULATION 

For an introduction to the powers of the PCjr's 
resident language, hold down Ctrl and 
Alt and press Del to reset the system. When 
the Ok prompt appears, type the com¬ 
mand statements exactly as they appear at 
right, starting with the print command. 

Press Enter at the end of each line. Note the 
different result caused by omitting the 
quotation marks in the last statement. 


The IBH Personal Cowputer Basic 
Uers ion Cl . 20 Copyright IBM Corp 1981 
62940 Bytes free 

PRINT "HERE IS MV FIRST PROGRAM ON PCJR" 


HERE IS 
Ok 

PRINT ”5893 + 3985 
5893 + 3985 
Ok 

PRINT 5893 + 3985 
9878 
Ok 


FIRST PROGRAM ON PCJR 


1 



2 i:UISG8 3 tiC*I:im 4 s-f:l«JJ4M 


MUSIC AND SOUND 

Clear the screen and turn off the key indica¬ 
tors at the bottom of the screen by typing 
cls:key off and pressing Enter. Now type the 
command statement, beginning with the 
word sound. Press Enter. You should hear 
the four notes of the ukulele tuning, "My 
dog has fleas." If not, check for typing errors 
and try again. To play another tune, type 
the last statement carefully and press Enter. 




BASIC, the computer language you 
use to communicate with the PCjr, is 
an integral part of the machine. 
When you turn the power on, the 
PCjr wakes up in Cassette BASIC, a 
special form of the language resid¬ 
ing in the computer's read-only 
memory (ROM). A more advanced 
form is Cartridge BASIC, which 
comes in a plastic cartridge, about 
the size of a deck of cards, that plugs 
into a slot in the front of the unit. 

Cassette BASIC is so named be- 
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cause it includes commands that let 
you transfer information and pro¬ 
grams to an audio-cassette tape re¬ 
corder for storage on magnetic tape, 
in much the same way you can re¬ 
cord, or store, music or voice. If your 
PCjr does not have a disk drive, you 
must use a cassette recorder to store 
your work; otherwise it will be lost 
when you turn the computer off. Cas¬ 
sette BASIC also offers numeric func¬ 
tions such as addition, subtraction, 
multiplication, division and square 


root, as well as the ability to handle 
text and to produce color graphics. 

Cartridge BASIC, with 32K of ad¬ 
ditional ROM, is an optional pur¬ 
chase designed to extend the capa¬ 
bilities offered by Cassette BASIC. It 
adds commands for using the disk 
drive to store and retrieve informa¬ 
tion, as well as powerful new com- 
mands for video graphics and 
sound. Cartridge BASIC also allows 
the PCjr to operate with a modem for 
telecommunications/'C/7opfer6j, with 











LINE GRAPHICS 

To execute graphics commands, you must 
first switch from the text screen you hove 
been using to a graphics screen. Type 
SCREEN 1. and press Enter. Now type the 
command statement shown on the screen 
at right exactly as it appears, and press 
Enter. A diagonal line should appear on the 
display. If it does not, check for typing 
errors and try typing the statement again. 



COLOR GRAPHICS 

Clear the screen by typing CLS and pressing 
Enter. Next, change the screen's back¬ 
ground color by typing COLOR4 and pressing 
Enter. Type and enter the second com¬ 
mand statement shown on the screen at right 
exactly as it appears. A light-blue square 
should appear on your display. If it does not, 
check for typing errors and try again. 



a printer for producing a hard copy 
of your work, or with other equip¬ 
ment such as joysticks and light pens. 

With Cassette BASIC as a building 
block, Cartridge BASIC extends the 
total number af available com¬ 
mands, statements and functions to 
more than 200. Because all this addi¬ 
tional power is kept on a ROM car¬ 
tridge, the PCjr's read-and-write 
memory is left free for any work you 
want to give it. 

The routines and screens shown 


here and on the next two pages are 
Intended to give you a quick tour of 
some of the highlights of Cassette 
and Cartridge BASIC. Note the dif¬ 
ferences in how the two levels of BA¬ 
SIC handle typed text or statements, 
perform mathematical functions, 
produce a sound or a tune and cre¬ 
ate lines and geometric figures. 

Although all of these routines are 
actually computer programs In sim¬ 
ple form, you need not try to deci¬ 
pher and understand them here; in 


Chapter 7 you will be more formally 
introduced to BASIC programs. For 
now, you need only type exactly 
what is shown on each screen, then 
watch and listen to what the PCjr 
does in response to your commands. 
If you make a typing error, just back¬ 
space to erase it. The examples here 
are merely a hint of the kinds of 
things it is possible to do with Cas¬ 
sette BASIC and Cartridge BASIC. 
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GEHING STARTED 


The Expanded Power 
of Cartridge BASIC 


MUSIC 

First insert Cartridge BASIC (box, below) and 
turn on the nnachine. Clear the screen by 
typing cls:key off. Type and enter the conn- 
mands exactly as shown on the screen at 
right. Be sure to type the letter O and not the 
numeral 0. You should first hear the four 
notes of "My dog has fleas/' just as you 
heard them in the Cassette BASIC ex¬ 
ample on page 26. Then you should hear the 
notes again at a faster tempo. Last comes 
the opening of "Three Blind Mice." 



LINE GRAPHICS 

Type screen l:color9,l and press Enter. The 

monitor should now display white text on 
a light-blue background, with only the Ok 
prompt and the cursor visible. Type each 
of the statements exactly as shown on the 
screen at right, pressing Enter after each 
statement. Your screen should now display a 
diamond. If you are using a monitor other 
than an IBM or a TV, the colors you see may 
differ from those shown here. 



Plugging In 
a Cartridge 

It does not matter whether the pow¬ 
er is on or off when you insert a car¬ 
tridge into the PCjr's system unit; 
neither the cartridge nor the com¬ 
puter will be damaged. But remem¬ 
ber that if you plug in or remove a 


cartridge while the machine is on, 
the PCjr will automatically reset it¬ 
self; anything on the screen or in 
memory will be lost. 

To insert a cartridge, hold it label 
side up, the open end with its pro¬ 
truding circuit card pointed away 
from you. Push the cartridge firmly 
into one of the slots on the right side 
of the system unit's front panel until 
it snaps into place. To remove a 
cartridge, grip it firmly and pull. 
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COMBINING MUSIC, PRINT AND COLOR 

Type cIs and press Enter to clear the 
screen. Type the command statement as it 
appears on the screen at right; pay close 
attention to the position of quotation marks 
and colons. Press Enter, then watch and 
listen. The words my DOG has fleas should ap¬ 
pear and the screen's background color 
should change as the note for each word is 
played. If not, check for typing errors, 
clear the screen and try again. 


Ok 

PLAY "MF-rPLAY "02 G":COLOR 1:PRINT "MY" 
;PLAY -01 G-:COLOR 2:PRINT "DOG":PLAY "O 
1 B-:COLOR 3:PRINT "HAS":PLAY "03 E-:COL 
OR 4:PRINT "FLEAS"! 



CIRCLES 

Clear the screen by typing cIs. Type and enter 
the first two command statements exactly 
as they appear on the screen shown at right. 
You should see a wedge shape (like a 
slice of pie) outlined in a contrasting color on 
a light-blue screen. Now type and enter 
the last statement. A complete pie should ap¬ 
pear around the slice. If you do not get 
these results, check for typing errors, clear 
the screen and try again. 



PAINT 

Keep the pie and wedge shapes from the last 
exercise (obove) on your display monitor. 
Type the last command statement as it ap¬ 
pears at right and press Enter. The 
wedge-shaped portion of the pie should turn 
pink. If It does not, check your typing for 
errors, clear the screen and re-create the 
shapes from the screen above by follow¬ 
ing those commands. Then re-enter the com¬ 
mand statements at right. 
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The Operating System: 
Directions from a Disk 


Your PCjr is a versatile machine, capable of performing 
simple tasks such as arithmetic or complicated ones such 
as arcade-style games. Each new task has its own set of 
instructions. These instructions — called software — tell 
the computer exactly how to use its circuits and mecha¬ 
nisms— the hardware — in order to do the job. 

An individual piece of software, called a program, di¬ 
rects the computer at each step of the job. BASIC, the 
language built into the computer's read-only memory, is 
one type of program. Most programs for the IBM PCjr 
are stored on separate disks or cartridges, to be loaded 
into the machine when required. Some program disks 
are packaged with the computer; others you will buy 
later, as you need them. You can also fill disks with pro¬ 
grams that you create yourself. 

Several levels of software are used with any computer, 
beginning with the set of programs called the operating 
system. These programs give the computer fundamental 
instructions: how to interpret information received 
through the keyboard or other input devices, how to 
process and store information, and how to display infor¬ 
mation on the monitor or other output devices. 


Higher-level software called application programs 
(diopters 4 and5) instruct the computer to perform com¬ 
plicated tasks such as word processing. Application pro¬ 
grams tell the computer how to manipulate information 
to yield the desired results. But they still depend on the 
programs in the operating system to do the basic work of 
taking information in, storing it and putting it out. You 
must first load the PCjr's operating system into read-and- 
write memory every time you want to use an application 
program, unless the program is self-loading (poge47). In 
some cases you must also insert Cartridge BASIC. 

The operating system for the IBM PCjr is called PC- 
DOS; these initials are IBM's proprietary name for Per¬ 
sonal Computer Disk Operating System. Several ver¬ 
sions of DOS have been introduced, as IBM has updated 
the operating system and tailored it to new models of the 
personal computer. The version of DOS that IBM sup¬ 
plies with your PCjr is identified on the disk and in the 
manual tor its use. To explore in detail the use of DOS tor 
sorting and storing information and running the system, 
read the IBM DOS manual. As you learn more about 
DOS, you will find the manual an invaluable tool. 


Though identical in appearance, these 
floppy disks for the PCjr hold completely dif¬ 
ferent contents. The disks store sets of 
instructions — called software — that tell the 
computer how to do its many jobs. 
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THE OPERATING SYSTEM 

Programs to Control the Computer 



Disk Drive 


Other DOS 
Programs 


Resident 

Commands 


SYSTEM UNIT 


DOS Disk 




^MEMORY 


The Disk Operating System (DOS) is a set of programs, stored in files on a 
disk provided by IBM. Certain command and control programs, known as resi¬ 
dent commands, manage information processing and the computer's links 
with input and output devices. The computer reads resident commands from the 
disk into memory, where they remain as long as the computer is on. Other 
DOS programs are brought into the computer's memory only when you enter a 
command that requires such a program; when no longer needed, these tran¬ 
sient programs are erased from memory but remain available on the disk. 


The Disk Operating System (DOS) 
gives the IBM PCjr instructions for 
basic machine tasks, such as loading 
an application program into mem¬ 
ory, reading input from the keyboard 
and writing information on a disk. 
When you want one of these jobs 
(called housekeeping functions) 
done, you give a simple command to 
DOS, and DOS tells the computer 
what to do, step by step. 

DOS performs this intermediary 
role for application software, such as 
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an educational or word processing 
program, eliminating the need for 
the program's manufacturer to in¬ 
clude housekeeping instructions on 
the program disk. For convenience, 
you can copy DOS programs onto 
an application software disk, where 
they will be available when needed. 

You put DOS programs in control 
of the computer by a process that is 
called booting (because DOS seems 
to pull itself into the computer by its 
own bootstraps). Instructions built 


into the computer tell it to look in its 
disk drive for further instructions. If 
the computer finds a disk, it then 
looks for a special DOS program 
called the boot record and reads the 
program into memory. The boot rec¬ 
ord then tells the computer where on 
the DOS disk to find the other pro¬ 
grams needed to control the system. 
The computer reads these so-called 
resident commands (illustrotion 
above) into memory, where they stay 
until you switch off the computer. 





















Date and Time: 
Starting up DOS 

Insert the DOS disk in the disk drive (if you 
have a second disk, labeled Supplemental 
Programs, ignore it for now). If the com¬ 
puter is off, turn it on; if it is already on, reset 
the system by pressing the Ctrl, Alt and 
Del keys simultaneously. When the computer 
has brought the DOS programs into 
memory, a prompt will appear on the moni¬ 
tor. Enter the date as shown in white 
Irightj, using either slashes (/) or hyphens (-). 
Do not enter the day of the week. If the 
computer responds ''Invalid date," try again. 



The time prompt shown at right indicates 
that the computer has accepted your date 
entry. Enter the time, using the form shown 
in white. You may enter just the hours and 
minutes, although the computer can ac¬ 
cept a time entry accurate to hundredths of a 
second, as indicated in the prompt. Enter 
the hour according to the 24-hour clock, add¬ 
ing 12 to the hour if the time is after noon. 



The A> prompt (rightj indicates that DOS is 
ready to carry out your commands and 
will refer to the disk drive for all the program 
files it needs, until you tell it to do other¬ 
wise. The primary floppy disk drive in a sys¬ 
tem is conventionally designated the A 
drive; a second drive is labeled the B drive. In 
single-drive systems, the terms A drive 
and 8 drive can refer not to separate drives 
but to different disks you insert in or re¬ 
move from the one drive (pages 38-39). 
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THE OPERATING SYSTEM 


A Disk’s Table 
of Contents 

dir a:/p <-l causes DOS to display a directo¬ 
ry — similar to the one at right — of the 
contents of the disk in the A drive. The com¬ 
mand can be in upper- or lower-case let¬ 
ters, but be sure to insert spaces, colons and 
slashes exactly as shown. Each entry 
identifies one file, the amount of space (in 
bytes) it occupies, and the date and time it 
was created. Adding /p (for pause) to the dir 
command stops the listing of files when 
the screen is filled; press any character key to 
make the display turn to the next page. 


A>clir A z / 

P 



1 COMMAND 

COM 

.1 7 7 2 

1 0-20-83 

1 ANSI 

SYS 

1 <b A 

1 0-20-83 

1 FORMAT 

COM 

<bS> 1 2 

1 0-20-83 

I C H K D S K 

COM 

<b A 0 e 

1 0-20-83 

SYS 

COM 

1 (b00 

1 0-20-83 

1 DISKCOPY 

COM 

257<b 

10-20-83 

DISKCOMP 

COM 

2 1 ea 

1 0-20-83 

COMP 

COM 

25 3 A 

10-20-83 

EDLIN 

COM 

A<bOS 

1 0-20-83 

MODE 

COM 

3 1 3 S> 

1 0-20-83 

F D I s h: 

COM 

4b3<b*? 

10-20-83 

BACKUP 

COM 

3<b a 7 

10-20-83 

RESTORE 

COM 

A 00 3 

10-20-83 

PRINT 

COM 

A<b0B 

1 0-20-83 

RECOVER 

COM 

230 A 

1 0-20-83 

1 ASSIGN 

COM 

8<?<b 

10-20-83 

TREE 

COM 

15 13 

1 0-20-83 

1 GRAPH ICS 

COM 

7 a<? 

10-20-83 

1 SORT 

EXE 

1 A0B 

1 0-20-83 

1 FIND 

E X E 

5008 

1 0-20-83 


key 

when ready 




dir a:/w causes DOS to display the di¬ 
rectory in a wide format of five columns 
across the screen. Only the titles of the 
files appear, allowing a quick survey of the 
contents of the disk. You may also use 
dir/w 4-1 (or, in the case above, dir/p); if you 
don't use a drive specifier such as a:, the 
computer automatically searches its default 
drive, the drive in which it is operating. 



COM EDLIN COM MODE COM 

FDISK COM BACKUP COM RESTORE 

COM PRINT COM RECOVER COM 

ASSIGN COM TREE COM GRAPHICS 

COM SORT EXE FIND EXE 

MORE COM BASIC COM BASICA 

COM 


23 File<s) 28<b'7 2 bytes tree 



DOS organizes and stores related 
information in files on disks, in much 
the same way that paper tiles are 
stored in a cabinet. But the magnetic 
coding that stores information on a 
disk is invisible; you can't find out 
what's in the files by rummaging 
through them. Instead, you can ask 
DOS to tell you the contents by using 
the dir command to display on the 
monitor a list- - or directory- of the 
files stored on the disk. 

The dir command comes in handy 
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when you need to find a file on a disk 
that is crowded with information. A 
single-sided floppy disk can hold up 
to 64 files and a double-sided disk 
holds 112 files — far too many to re¬ 
member or even to write down con¬ 
veniently. You can instruct DOS to do 
the searching for you, using the vari¬ 
ations of the dir command shown 
above to display the directory in an 
abbreviated form, to search for an 
individual file or to list a group of re¬ 
lated files. The version of DOS la¬ 


beled DOS 2.10 also has a provision 
for subdirectories, so you can group 
related files under a single title in the 
main directory. 

Files on the DOS disk and other 
program disks were created, named 
and recorded by the software manu- 
facturers. You will have to do the 
same when you compile your own 
information on blank disks: It must all 
be stored in named files. Once you 
provide the names (box, right), DOS 
will take care of organizing the files. 










dir a:basic.com <-l causes DOS to dis¬ 
play the directory entry for the file you request 
(in this case bosic.com), so you can be 
sure it is on the disk and find out its size and 
time of entry. Any individual file can be 
called up in this manner. 




dir a:*.exe <-l causes DOS to display all 
the file titles that have a specified part in com¬ 
mon (in this case .exe). An asterisk is a 
'Vild card/' representing any combination of 
characters appearing in the name or the 
extension of a filespec. Typing the command 
dir aiaccount.* for example, would 
list all the file titles that begin with account. If 
either part of the name is omitted in the dir 
command, the computer reads the character 
* and will list the files accordingly. 



How to Name 
Your Files 

DOS recognizes file titles (IBM 
calls them tilespecs) only if they 
are written in a particular way, 
with special attention to spaces 
and punctuation. A filespec must 
include a filename of one to eight 
characters; this may be followed 


by a period and an extension of 
one to three characters. Any mix 
of letters and numbers is accept¬ 
able to DOS (but avoid symbols 
suchas(«,\and # in files pecs; 
some have special meanings to 
DOS, and it may respond to com¬ 
mands you didn't mean to give). 

DOS can remember xxplm%& 
as easily as rufdroft, but you 
should choose a name that re¬ 
minds you of a file's contents. You 


can use an extension (or filetype) 
as a guide to the content of a file; 
for example, you might use the ex¬ 
tension .corforall correspon¬ 
dence. Extensions are also helpful 
when you want to find related 
files. Be sure to include the exten¬ 
sion when you call a file up; for 
most DOS commands, the exten¬ 
sion— or the substitute character 
* (screen, above) — is a necessary 
bit of identification. 
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THE OPERATING SYSTEM 


Magnetic Patterns 
for Easy Filing 


A FORMAT FOR FILES 

DOS organizes information on a disk by stor¬ 
ing it in 0 pattern of arc-shaped areas de¬ 
fined by magnetic coding. The format com¬ 
mand records this pattern on a blank disk, 
creating 40 concentric tracks and nine 
wedge-shaped sectors. Before storing 
files on a disk, you must format it, using DOS. 



HOWTO FORMAT WITH ONE DRIVE 
format /s<-i begins the formatting sequence 
in a one-drive system like the PCjr's, with 
the DOS disk in the drive. DOS reads the for¬ 
mat program from the disk, stores it tem¬ 
porarily in memory, then prompts you to in¬ 
sert a new disk in the drive. Remove the 
DOS disk, insert a blank disk and press any 
character key. Adding /s causes DOS to 
transfer command and control files to the 
new disk, which then will be self-loading; 
you can load it into the computer without us¬ 
ing the main DOS disk. 



Handling Floppy Disks 


The PCjr can store information on 
flexible plastic disks, known as flop¬ 
py disks to distinguish them from 
the rigid 'Tixed disks" used in some 
computers. Handle a disk only by 
its jacket, and always store it in 
its paper sleeve. Keep disks away 
from heat sources and equipment 
that generates magnetism, such 


as telephones and tape recorders. 

To prevent accidental erasure, 
cover the write-protect notch (right) 
with a gummed tab provided by the 
maker. When this notch is covered, 
the disk drive can read information 
from the disk through an opening 
called the head slot, but it cannot 
record or erase anything. 
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While the format is being recorded, the 
message "'Formatting . . !' will appear on the 
monitor. If memory cannot hold all the 
command and control files at once, the ma¬ 
chine will tell you to reinsert the DOS disk 
until all the files are transferred. When this is 
done, "System transferred" appears on 
the monitor, plus a note about disk space 
filled by the DOS files and a query about 
repeating the sequence. If you want to format 
another disk, type y and proceed; if not, 
type n and return to normal DOS control. 



■40*?di0 byt.es used by system 
3215 3 <b bytes availaible on disk 


Format another (Y/N)"? 



FORMATTING FOR EIGHT SECTORS 
DOS 2.10 will create nine-sector patterns un¬ 
less you give other instructions. Adding /8 
to the format command {screen, right) will 
make the target disk compatible with ear¬ 
lier versions of DOS that read only an eight- 
sector pattern. By adding /I you can also 
tell DOS to format a single-sided disk usable 
in single- or dual-sided drives. 





Some floppy disks hold more than 
360,000 characters, the equivalent 
of about 125 typed pages. Sifting 
through that much information for a 
file could cause delays; to avoid 
them, DOS uses a reference sys¬ 
tem— a format — on each disk. The 
format command causes DOS to 
record on a disk a pattern of mag¬ 
netic tracks and sectors (diogrom, 
opposite, top). DOS will then store in¬ 
formation, note the track and sector 
of its location, and be able to find it 


again. The format command also 
causes DOS to find out whether the 
disk and the target drive are single- 
or dual-sided (see "'FORMAT Com¬ 
mand" in your IBM Disk Operating 
System manual), and to format the 
disk accordingly. Disks formatted for 
single-sided use will work in the 
PCjr's drive, which is dual-sided. But 
when a disk is formatted for dual¬ 
sided use, space is allocated differ¬ 
ently than for a single-sided drive; 
therefore you cannot use a dual¬ 


sided disk in a single-sided drive. 

The format /s command illustrat¬ 
ed here makes DOS do double duty, 
causing it to transfer command and 
control files to the new disk as well 
as formatting it. 

WARNING: Formatting a disk 
erases all information stored 
there. Usually you need to for¬ 
mat a disk only once — before us¬ 
ing it the first time. If you refor¬ 
mat an old disk, be sure that it 
holds no valuable files. 

37 










THE OPERATING SYSTEM 




Destination 


Source 


Copying Files to 
Transfer Data 


COPY CON: A: 


The copy command, illustrated in the dia¬ 
gram at right, causes DOS to read informa¬ 
tion from a source, store it in the comput¬ 
er's memory and then write a copy at the 
destination. Copy is commonly used to 
copy files from disk to disk, but you can use it 
with a variety of sources and destinations. 


You can use the copy command to trans¬ 
fer information between system devices, as 
shown at right, by indicating the source 
and destination. Each device is known to 
DOS by a device name; note that a de¬ 
vice name always ends with a colon, to differ¬ 
entiate it from a file title. 

If you do not name a source or a destina¬ 
tion, DOS assumes that the source or des¬ 
tination is the disk currently in the disk drive, 
indicated by the DOS prompt, A> or B>. If 
you don't enter a new filespec for the newly 
copied file, DOS will use the old name. 

























To make a backup^ copy of the DOS disk, 
put the DOS disk into the A drive and type 
copy a:*.* b: «-l to begin the copying 
process. The expression *.* — with the wild¬ 
card asterisk in both parts of a filespec — 
means "'all files." The codes A: and B: here 
refer to source and destination disks. 

DOS reads the file from the source disk (A:), 
stores it in memory and then tells you to 
insert a disk "for Drive B:". Remove the 
source disk and replace it with the desti¬ 
nation disk (B:) and press any character key. 



Insert. diskette for. drive B: and strike 

any key when ready 


Insert diskette -for drive A: and strike 

any key when ready 
A : FORMAT . COM 


any key w^ 1 en ready 



As the computer copies files from one disk 
to the other, it displays a list similar to the one 
at right. You will have to switch the source 
and target disks 23 times, once for each DOS 
file. When the copying is complete, the 
computer reports how many files it copied. 



Insert diskette for drive Ai and strike 
any key when ready 
A:BASICA.COM 


Insert diskette -for drive B: and strike 
ar»y key when ready 


Insert diskette -f or drive As and strike 
anv key when ready 



Your first use of the copy command 
will be to moke o backup copy of the 
DOS disk, so that you won't be left 
without on operating system if some¬ 
thing happens to the original. The 
versatile copy command will also 
become one of your most useful 
tools for moving and storing oil your 
files, and for printing and displaying 
files received from keyboard input or 
from other computers (poges67-73). 

Because the copy command has 
so many uses, you must compose it 


carefully. To give you the results you 
want, DOS must know the intended 
source, the intended destination and 
the filespec of the information you 
want to copy. The source and desti¬ 
nation are entered as device names: 
acronyms identifying input and out 
put devices (opposite). 

A properly composed copy com 
mand always starts with copy fol¬ 
lowed by the name of the source de¬ 
vice. Next comes the filespec of the 
source file, then the name of the des¬ 


tination device and finally the file- 
spec by which the copied file will be 
known. Remember to differentiate 
between the letters / and O and the 
numerals / and 0. 

Pay attention to filespecs when 
you are copying. Each file on a disk 
must have a unique filespec; if you try 
to store new information under a file- 
spec already in use, DOS will erase 
everything it has previously stored 
under that filespec as it writes the 
new information. 
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THE OPERATING SYSTEM 


A Variety of Uses 
for the Copy Command 


copy aimusic.bas b: causes DOS to copy o 
file (in this example, music.bas) from one 
disk to another, where it will be stored with 
the some name. Entering the command 
copy aimusic.bas bisong.bas would result 
in the copied file's being stored on the tar¬ 
get disk with a new name — song.bos. 



copy aiart.bas pix.bas ^ causes DOS 
to copy a file (in this case, ort.bas) to the 
same disk, but with a different name 
(here, pix.bos). The result is two files on the 
disk that are identical in all but name — 
useful if you want to make changes to a file 
while retaining a copy of the original. 


copy aiprog.asc Iptl : <-i causes DOS to 
copy a disk file — in this case, prog.osc — 
from the disk in the drive to the printer. 

This is useful when you want to have a paper 
record of a disk file that has been stored in 
a readable format — such as a file created by 
copying keyboard input (opposite! or a file 
of text sent from another computer (poge 70). 
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Copying Files 
from the Keyboard 


copy con: oifrog.ltr causes DOS to 
save information entered at the keyboard (or 
console) to store in a file on a disk in the a: 
drive — in this cose, under the name frog.ltr. 
When you enter this command, DOS be¬ 
gins saving all keyboard input in memory, for 
Ia1er transfer to the disk file. This is useful 
for saving a short file, such as a memo, or a 
list of commands for DOS to execute later. 



As you type, you must occasionally end a 
line by pressing the Enter key If you fail 
to do so, the computer will make a buzz¬ 
ing sound and may appear to stop operat¬ 
ing; it cannot process extremely long lines. 
Even though it seems to start new lines by it¬ 
self, the computer reads what you type as 
a single line until you type <-l. 

Your signal to DOS that the entire file is 
ended is to type "Z 4-1 (press Control and Z si¬ 
multaneously; release them, then press 
the Enter key). When it receives this end-of- 
file character, DOS transfers the file from 
memory to the named disk file. 



copy con: Iptl : causes DOS to copy in¬ 
formation entered at the keyboard directly to 
the printer. As in the case of a file copied 
from the keyboard to a disk, DOS saves the 
information in memory until you type the 
end-of-file character, *Z <-l. Then the entire 
file is sent to the printer. This command is 
useful when you want a paper copy of the in¬ 
formation but don't need to save it on a 
disk, as in the case of a short memo. 
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THE OPERATING SYSTEM 


DOS Commands 
for Other Tasks 


chkdsk a: <-l causes DOS to scon the con¬ 
tents of the designated disk and report the 
number of files on it and the amount of space 
left. It is important to keep track of the free 
space on each disk, since some programs 
may lose data when there is not enough 
space available to save a file. 



del adrog.ltr <-l causes DOS to delete 
the designated file, in this case frog.ltr. Typ¬ 
ing the command erase aifrog.ltr <-l has 
the same result. These commands are useful 
for eliminating outdated files, n.aking 
room on the disk for more data. 




As you gain more practice with DOS, 
you will discover more commands 
that help you create and handle files. 
Some of these are shown above and 
at right; many others are explained in 
the IBM DOS manual. 

One command not shown here is 
diskcopy. This command is similar 
to copy *.* (page 39), but it does 
more than simply copy the files. 
Diskcopy erases everything on the 
target disk and then transfers the 
format (page 36) and the operating 
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system in addition to the files. 

Another command you may need 
is mode, which can set up the com¬ 
puter to use a nonstandard printer, 
or can change the way the monitor 
displays information, as required for 
some graphics uses. 

WARNING: If you have disks that 
have been formatted in different 
versions of DOS, do not mix pro¬ 
grams from different versions on 
one disk. If you do so, and then 
use chkdsk,com or diskcopy.com, 
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incompatible programs can erase 
data from the disk you are check¬ 
ing or copying. If a disk drive spins 
continuously during chkdskor 
diskcopy, incompatible programs 
may be the explanation. Switch off 
the computer, remove the disks, 
and then use the copy command to 
put the compatible command.com, 
chkdsk.com and diskcopy.com 
programs onto the affected disk. 







rename arfrog.ltr green.Itr causes 

DOS to change the name of a file, in this case 
from frog.Itr \o green.Itr. If you type 
ren frog.ltr green.Itr <-l you will get the 
same result. These commands affect only 
the names of files; they have no effect on the 
data stored in the files. 



type argreen.ltr <-l causes DOS to dis¬ 
play the contents of the designated file on the 
monitor. This command lets you find out 
quickly what is in a file. If the file was created 
using an application program, the type 
command may result in a display that con¬ 
tains seemingly meaningless graphics 
symbols. These symbols represent special 
codes that some programs insert in files 
for their own housekeeping purposes. 



sys b: <-l causes DOS to copy the operat¬ 
ing system files from the DOS disk to another 
disk. You will use this command to make 
an applications program disk self-loading — 
to prepare it so that you can use it without 
first loading DOS into memory. The prompt, 
'"Insert a diskette for drive B:" means that 
you should remove the DOS disk and insert 
the applications disk. Most applications 
programs also require that you add the DOS 
command.com file; after the sys command 
is executed, type copy aicommand.com b: 
to complete the preparation of the appli¬ 
cations program disk. 
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Education and Entertainment 


Games and learning are strands of the same rope. By 
playing games that imitate the world, children sharpen 
their physical and social skills: coordination, memory, 
quick reflexes (both mental and physical), the ability to 
work with others. Prehistoric children may have tossed 
sticks and pebbles on the sand, or played at hunting with 
crude bows and arrows. Children since have learned to 
experience and master the world around them by play¬ 
ing such games as hide-and-go-seek and soccer, doll¬ 
houses and train sets, chess and parcheesi. Today's chil¬ 
dren have added computer games. 

But you don't have to be a child to enjoy playing 
games on your PCjr, or to learn on it. Given the right 
software, the PCjr can challenge not only the fingers but 
the minds of children and adults alike. 

Games for the PCjr come in several guises, from the 
fast-action shoot-'em-ups of arcade-style entertain¬ 
ment, to the familiar strategies of blackjack and chess, to 
the structured environments of adventure simulations. 
Some of these adventures are text-oriented interactive 
fiction: You respond, via the keyboard, to a series of 
questions or statements. Other simulations fill the screen 


with vivid graphics. Perhaps more important, by having 
you play a role in the drama, simulations can encourage 
you to look at problems from a new perspective. 

Simulations play an important part in educational soft¬ 
ware as well. As personal computers become more 
powerful and thus more versatile, such approaches as 
drill-and-practice and electronic text are giving way to 
simulations and other programs that allow more interac¬ 
tion between machine and student. The best educational 
packages not only demonstrate ideas and concepts, but 
also test and evaluate a learner's performance. More¬ 
over, they present the material through colorful graphics 
and a strong story line. 

If an educational package seems too much like a glori¬ 
fied game, remember two things: A computer is only as 
good a teacher as its software allows it to be, and boring 
software is rarely used more than once. Consult with a 
schoolteacher who works with a computer for help in 
evaluating available programs. Whether labeled educa¬ 
tion or entertainment, the best of these software pack¬ 
ages encourage you to learn from your mistakes — and 
to have fun with your computer while you do. 


A high-tech version of chess can take place 
on a computer screen, with game pieces 
and a multicolored board created electroni¬ 
cally, but three replicas of walrus-ivory 
chessmen from 12th Century Scandinavia 
serve as reminders of the game's ancient 
traditions. Chess programs for the PCjr can 
play against you at several levels of skill, 
or let you play against a human opponent. 
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EDUCATION AND ENTERTAINMENT 


Learning Games 
for Youngsters 


This flashcard-like tutorial introduces chil¬ 
dren between two and six years old to letters, 
numbers and words. When a character or 
a picture of a familiar object or animal ap¬ 
pears on the PCjr's screen, the child re¬ 
sponds by typing the matching character, or 
by spelling the word for the number, ob¬ 
ject or animal. Very young children can ask 
the computer to display the words in out¬ 
line (right) as an aid to finding the matching 
letters. Sound effects and an animated 
character celebrate correct answers. 



APPLE 




Spell object shown, (key ALT B to stop) 



A set of six educational games, graded by 
difficulty, teaches four- to 10-year-olds to use 
pairs of numbers and letters to identify co¬ 
ordinates on an array or grid (right). Players 
enter coordinates to uncover hidden num¬ 
bers or cartoon characters, to play a version 
of tick-tack-toe, or to draw a picture. In¬ 
correct entries prompt hints from the comput¬ 
er; correct answers are rewarded with 
colorful graphics, music and praise. 
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To turn your computer into a useful 
educational tool and a patient 
teacher, you must get software that is 
suited to your needs. As illustrated 
here and on the following pages, 
there are several kinds of programs 
to choose from, depending on the 
age of the user and the type of in¬ 
struction desired. 

You will want to help young learn¬ 
ers get started, of course, but they 
should be able to proceed at their 
own pace. Look for programs that let 


the learner control the length of 
screen display time and that offer in¬ 
struction for several age levels. 

Check the program's method of 
dealing with repeated failure. Some 
tutorials loop the learner back to ear¬ 
lier instruction, some present the right 
answer and an explanation, and 
others branch the learner to an alter¬ 
nate treatment of the same problem. 
Finally, be sure the maker will re¬ 
place the program disk for a nominal 
charge in case of damage. 
















An adventuresome way to improve basic 
mathematical skills, this game challenges 
learners to find their way through a cas¬ 
tle maze of passageways and rooms (right). 
Players may choose problems in addition, 
subtraction, multiplication or division. Solving 
the problems will open doors, win trea¬ 
sure and score points. The top 10 scores and 
players' names are listed at the top of the 
screen at the end of each game. 



Quick math reflexes are the goal in this 
educational game, which pits the learner 
against a series of math problems, a 
three-headed monster and a 60-second 
clock. Six levels of difficulty increase the 
challenge of problems in adding, subtracting, 
multiplying and dividing. Correct answers 
make the monster disappear, part by part, 
and score points; wrong answers keep 
the monster alive longer. 



Preparing Your 
Program Disk 

With some game and educational 
programs, you will have to copy the 
PCjr DOS command file onto the 
master disk to make the program 
self-loading; otherwise, you have 
to load DOS first every time you 
want to start the program. With oth¬ 


er programs, the necessary boot 
record is already on the disk when it 
comes from the manufacturer. Ex¬ 
amine the documentation carefully. 
It should spell out exactly what 
equipment you will need and de¬ 
scribe clearly how to start the pro- 
gram, including step-by-step 
instructions for putting the DOS 
command file on the program disk 
if that step is necessary. 

Make a backup copy of the mas¬ 


ter disk if possible. (Some disks 
cannot be copied; you get a life¬ 
time guarantee on the master disk 
instead.) Use the copy and save the 
master; that way, if anything goes 
wrong, you can make another 
copy. Some game instructions also 
suggest that you format a working 
disk for recording your various 
strategies. In that case, the docu¬ 
mentation should also explain how 
to save your moves for replays. 
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EDUCATION AND ENTERTAINMENT 

Curricula for Your 
Computer Classroom 


Designed to promote deductive reason¬ 
ing, analytical thought and creativity in eight- 
to 13-year-olds, this collection of five edu¬ 
cational games in one builds on coordinate¬ 
plotting skills that have been learned in a 
companion game Ipoge 46). Players guess 
coordinates, or a range of coordinates, 
to trap a robber or to find hidden treasure. 
Mistakes elicit on-screen help state¬ 
ments. Correct answers win colorful graphics 
and musical vignettes. 



Daily sessions with an interactive tutorial 
like the one shown at right can help improve 
your reading speed and comprehension. 
Each session includes exercises to improve 
perception, peripheral vision, eye span 
and movement, and reading speed. The pro¬ 
gram keeps track of your progress. A spe¬ 
cial editor feature lets you enter your choice 
of reading material, analyzes it and gives 
you its approximate grade level. 



Your PCjr has many of the attributes 
of a good teacher: It can call upon 
vast amounts of knowledge, pose 
questions and score responses, 
keep track of progress and repeat 
teaching sequences with infinite pa¬ 
tience. If you plan to use your PCjr for 
educational purposes, you should 
give careful consideration to two 
things: the software you select and 
the monitor you use for display. 

Composite-video monitors are 
adequate for most educational pro- 
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grams; they are less expensive than 
RGB monitors as a rule, and will gen¬ 
erally provide sufficient resolution for 
most graphics. Bear in mind, howev¬ 
er, that many composite-video mon¬ 
itors have trouble displaying more 
than 40 characters per line; if much 
of your material is textual, you may 
prefer the higher-resolution, 80- 
character screen of an RGB monitor. 

Good educational software holds 
the user's interest with some of the 
same devices that make computer 


games appealing — high-quality 
sound and graphics, and routines 
that call for frequent interaction. The 
element of enjoyment is just as im¬ 
portant to computer learning as it is 
to classroom education. 

Several types of educational soft¬ 
ware are available for the PCjr. The 
most common leads you through 
practice drills, generally of informa¬ 
tion you have learned elsewhere, 
such as arithmetic, spelling or a lan¬ 
guage. Some drill programs keep a 













Among the tutorial programs available for 
the PCjr are some designed to teach stu¬ 
dents how to take college-entry examina¬ 
tions. The examples at right are drawn 
from the verbal (fop) and math /boffomj tutori¬ 
al sections for the Scholastic Aptitude 
Test. Students proceed at their own pace, se¬ 
lecting from a lesson menu and then 
working in one of three modes; instruction, 
test or timed test. In the instruction mode, 
the program teaches new material by provid¬ 
ing hints and clues if the student does not 
get the right answer the first time around. 


W SELF-EFFACING 

: BRAGGART : : 


■ A. stentor'ian 

: politician 

1 

1 B. y'igox'ous : 

athlete 

I 

1 C. deLaucher'y 

; aesthete 

1 

B. loquacious 

: silent 

1 

E. pretentious 

: debutante 


Type your answer and press 

ENTER: 


to skip this 

question 1 

L_ . 

to quit this 

drill 1 


If gasoline costs $1.24 pep gallon and 
a cap avepages 28 Miles to a gallon, 
how Much will the dpivep spend on 
gasoline to tpavel 532 Miles? 


A. $19.00 

B. $21.24 

C. $23.56 
B. $28.00 
E. $29.36 


Type youp answep and ppess ENTER: _ 


Type 0<0Mit> to skip this question 
Type Q(Quit) to quit this dpi 11 
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record of your correct and incorrect 
answers to let you keep track of your 
progress. Some allow you to make 
up your own questions and answers 
for later review. There are even pro¬ 
grams that drill you on musical notes 
and scales and then allow you to 
compose your own tunes. 

A second type of program, the tu¬ 
torial, does more active teaching. 
These programs present a sequence 
of textual information; some periodi¬ 
cally pose questions to make sure 


that you understand the concepts, 
and if you answer correctly, they ad¬ 
vance and present more informa¬ 
tion. Tutorial programs are used to 
teach the basics of such disciplines 
as algebra, geography and astron¬ 
omy, as well as computer languages 
such as Logo and BASIC. 

Another, more sophisticated type 
of program simulates real situations 
and their concomitant problems: 
You learn by working through the dif¬ 
ficulties. This type of software might 


present the purchasing and pricing 
problems of a small business or, for 
children, the problems of distributing 
equal volumes of liquids into odd¬ 
shaped containers. 

The hallmarks of good education¬ 
al software, wherever you find it, are 
clear instructions, commands that 
use keys logically, and the graphics, 
color and sound effects that keep the 
learner interested. 
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EDUCATION AND ENTERTAINMENT 


The PCjr’s Electronic 
Action Gameboard 


To score in this fast-paced, orcode-style 
gome, you must maneuver your mining cor to 
gather gems, and fire your loser gun to 
disable the robots rampaging through the 
twisted shafts on each of the mine's 10 
levels. Your current score and whereabouts, 
os well os the high score to beat, ore post¬ 
ed on the right side of the screen. The gome 
comes in cartridge form and may be 
played with the keyboard or o joystick. 



With a red-green-blue (RGB) monitor, you 
can play this three-dimensional tick-tack-toe 
against the machine or another player. 

The object is to get some of your pieces to 
form a horizontal, vertical or diagonal line 
on any level, or through all four. The levels 
ore numbered from top to bottom, the 
rows from front to bock, the columns from left 
to right. Typing the three-digit number 
234, for example, would put your piece in the 
second level, third row from the front, 
fourth column from the left. 



HUMAN US MACHINE 


M * S TURN fJ 
INPUT ;xxx 

LAST MOUE: 422 
MOUES MADE: 16 
SKILL LEUELS 


yPE yOUR MOUE 


For some of the gomes you con play 
on your PCjr, joysticks are an option¬ 
al controller, more flexible than key¬ 
board controls. IBM sells a joystick 
for the PCjr, but you may also use 
one made by another manufacturer. 

There are two categories of joy¬ 
sticks— discrete and proportional 
(the PCjr model is proportional). The 
discrete type is the simpler and less 
costly. It can direct the cursor or on¬ 
screen game character in only eight 
directions: the four points of the com¬ 
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pass and four diagonals. It cannot 
control speed or distance traveled. 

A proportional joystick, by con¬ 
trast, can move the cursor or game 
character in any direction, and the 
speed and distance the cursor 
moves correspond to the move¬ 
ments of the joystick. With a better- 
quality stick, you will also be able to 
move the cursor or character a very 
small distance at a time. The major¬ 
ity of joysticks have a trigger or trig¬ 
gers mounted on the stick, for func¬ 


tions that vary from game to game. 

Once attached to the computer, 
the joystick will need adjusting. For 
some games, you may want the stick 
to be self-centering — to rebound to 
the center position when you let go; 
for other games, you may want it to 
stay where you leave it. You may 
also need to calibrate the stick so its 
moves are coordinated with the cur¬ 
sor. Some games have a diagnostic 
screen for this; if yours doesn't, ex¬ 
periment to set the stick properly. 






























A disk drive and Cartridge BASIC let you 
enter the world of chance in this colorful 
package of three classic casino games on 
one disk: blackjack, slot machine and poker. 
Up to four players at a time may gamble, 
each with a $500 stake. In the card games, 
the computer deals; for slot machine, the 
player pulls the handle by pressing the key¬ 
board space bar. The slap and snap of 
the cards and the whir of the slot machine ac¬ 
company play. You can carry your win¬ 
nings from game to game within the casino. 



Through a series of computer-human ex¬ 
changes similar to those shown at right, ad¬ 
venture game players pursue a goal 
through deserts, forests and mountains, fend¬ 
ing off danger and trying not to get lost. 

As the human player learns the rules (mostly 
by trial and error), the exchanges become 
less maddening and more rewarding. De¬ 
pending on the game, players may be 
armed with information, weapons, or words 
with magical properties. Solving the prob¬ 
lems posed by these programs can take 
days — and sometimes weeks. 



Simulations like the one at right conjure up 
another world and put you in charge — in this 
case, of a 19th Century railroad. To make 
your company grow, you must achieve a 
complex series of objectives, filling up with 
coal when necessary, repairing broken ma¬ 
chinery, picking up and delivering various 
cargoes to keep industry and marketplace 
supplied. If you succeed, more track is 
laid — making the next series of pickups and 
deliveries that much more complicated. 
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EDUCATION AND ENTERTAINMENT 


Mastering Logo with 
the Help of a Turtle 


Using simple commands in the compu¬ 
ter language called Logo, you can program 
graphics like those shown here, starting 
with a small procedure — to create a twig 
Iright) — and using it to build others. To 
define the procedure TO TWIG, you type a 
series of instructions, such as FORWARD 
(or FD) 20 or LEFT (or LT) 45. If you then type 
TWIG, a triangular cursor called the turtle 
will obey each command, moving forward 20 
steps or making a 45° left turn, leaving 
lines on the screen to draw the shape. 



From the small unit of a twig, you can then 
build a larger unit — a branch. Again you 
must define the procedure — in this case, 

TO BRANCH. By using TWIG, the procedure 
already created and defined, you can de¬ 
fine TO BRANCH in instructions that appear 
to be a kind of shorthand: TWIG, FD 30, 
TWIG, FD 30, TWIG — and so forth. If you 
then type BRANCH, the turtle will draw a 
shape like the one shown at right. 



Logo is 0 computer language that 
can give you or your child a gratify¬ 
ing sense of mastery over the ma¬ 
chine. In minutes you can teach the 
computer to do your bidding — and 
in the process, gain an intuitive un¬ 
derstanding of programming. 

The key to Logo's success as an 
educational tool is a feature called 
turtle graphics. The turtle — a small 
triangular cursor — moves in re¬ 
sponse to typed commands such as 
FORWARD 10 ( move forward 10 
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steps) and RIGHT 90 (make a 90° 
right turn). As the turtle moves, it cre¬ 
ates a design on the screen, allowing 
you to watch your commands in ac¬ 
tion. (Commands may be abbreviat¬ 
ed — FD and RT, for example.) 

If you make a mistake — by typing 
GD or COWARD, say — the turtle 
mildly responds, "I DON'T KNOW 
HOW TO GOWARD." In much the 
same way children learn to talk, you 
learn Logo's vocabulary and gram¬ 
mar by interacting with the turtle. 


As you master simple procedures, 
you can use them to build more com- 
plexones — which is the beginning of 
programming. First you learn to 
name a procedure — TO TWIG, for 
example, might be a procedure to 
draw lines that resemble a twig (top 
screen, above). Then you define the 
procedure by typing each step need¬ 
ed to draw the shape. Once the pro¬ 
cedure has been defined, you have 
only to type TWIG, and the turtle will 
draw one without further ado. 











With BRANCH (which incorporates TWIG), 
you con now teach the turtle to draw a 
shrub. You define the procedure TO SHRUB 
by typing commands such as LEFT (or LT) 

75, BRANCH, REPEAT 10 [RIGHT 15 
BRANCH]. The REPEAT command tells the 
turtle to do a procedure a given number of 
times. In this case, the turtle will make a 
75° left turn and execute BRANCH; then it will 
do the two steps in brackets — turn right 
15° and execute BRANCH — 10 times. 



To create the last screen — a copse, or 
thicket of small shrubs — you use SHRUB to 
define the new procedure TO COPSE, just 
as you used BRANCH to define SHRUB. With 
other instructions built into Logo — such as 
SETPC, for Set Pen Color — you can tell the 
turtle what colors to make each shrub. If 
you include these instructions in the definition 
of the procedure, the turtle will create a 
colorful screen as soon as you type COPSE. 



More Languages 

Logo is one of hundreds of pro¬ 
gramming languages. Designed to 
teach children math, it is used for 
graphics programs and can also 
handle text. Here are brief descrip¬ 
tions of five other languages: 
FORTRAN was the first widely used 
computer language. It can serve as 
a general-purpose programming 


language, but Its forte is scientific 
and engineering applications. 
COBOL was developed for business 
and commercial applications. It 
uses words and phrases similar to 
English, making It easy to read. 
BASIC is an interactive language 
that gives the user an immediate re¬ 
sponse to what is typed into the 
computer. The most popular lan¬ 
guage for microcomputer users, 
BASIC Is adequate for many busi¬ 


ness and commercial applications. 
Pascal is useful for anyone study¬ 
ing computer science. It is best suit¬ 
ed for long, complex programs. 
LISP (List Processor), is the lan¬ 
guage of choice for artificial intelli¬ 
gence (Al) research because of its 
ability to manipulate symbols — the 
hallmark of human thought. As mi¬ 
crocomputers increase in power, Al 
technology is showing up in games 
and educational software. 


53 








EDUCATION AND ENTERTAINMENT 


Creating a Game 
with Logo 


To create a simple program for the game of 
Pick Sticks, you must first define an overall 
procedure. As shown at right, the main pro¬ 
cedure, TO PICKSTICKS, contains a num¬ 
ber of subsidiary procedures. Beginning with 
TO RULES, each subprocedure must be 
defined before the game will work. 

(The procedures TEXTSCREEN, CLEAR¬ 
TEXT and MIXEDSCREEN are Logo ''primi¬ 
tives," basic procedures built into the lan¬ 
guage; you need not define them.) 



TO PICKSTICKS 

RULES 

PLAYERS 

SETUP 

PLAY 

END 


TO RULES 

TEXTSCREEN CLEARTEXT 

IF RC = "N ESTOP! 

PRINT El PRINT El 

PRINT EYOU START WITH 15 STICKS. 1 
PRINT EYOU MAY PICK UP 1^2, OR 31 
PRINT ESTICKS AT A TIME.) 

PRINT ETHE PLAYER WHO PICKS UP THEl 
PRINT ELAST STICK IS THE WINNER!1 
WAIT 200 
END 


The next subprocedure that needs defini¬ 
tion is TO PLAYERS, to get the names of the 
two players. This is followed by a defini¬ 
tion of the TO SETUP procedure, to set 15 col¬ 
ored sticks in position on the screen. 

Drawing the sticks is a complicated proce¬ 
dure in itself, so in planning SETUP, simply 
call this procedure DRAWSTICKS. Then, in 
the next step, define TO DRAWSTICKS. 


I 


TO PLAYERS 
TEXTSCREEN CLEARTEXT 

PRINT ETHIS IS A GAME FOR 2 PLAYERS. 1 
EFIRST PLAYER'S NAME?1 
•PLAYERl HEADWORD 
E 1 

PRINT ESECOND PLAYER'S NAME?1 

MAKE "PLAYER2 HEADWORD 

END 


PRINT 

MAKE 

PRINT 




TO SETUP 

CLEARSCREEN MIXEDSCREEN DRAWSTICKS 

MAKE “REMAINING 15 

END 


TO DRAWSTICKS 

PENUP SETPOS E-130 101 

REPEAT 15 ESETPC 1 + RANDOM 3 STICK RIG-» 
HT 90 FD 18 LEFT 901 
SETPOS E-130 101 
END 


J 


Once you have learned the princi¬ 
ples of turtle graphics, you can ex¬ 
periment with writing simple pro¬ 
grams for such familiar games as 
Pick Sticks (above ondopposite). Be¬ 
fore beginning, follow the instruc¬ 
tions in the Logo manual for making 
a file disk so that you can save your 
game program when it is completed. 

The first step in planning a Logo 
program is to divide the project into 
its most obvious segments or pro¬ 
cedures. In the case of the game il¬ 
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lustrated on these pages, the overall 
procedure is called PICKSTICKS; the 
segments might be: giving the RULES 
of the game, getting the PLAYERS' 
names, SETTING UP the screen and 
starting to PLAY. After naming these 
key procedures, you must then de¬ 
fine them. The definition may in¬ 
clude simple steps like FORWARD 20 
(pages 52-53); it may also include 
subsidiary or subprocedures, which 
must be defined. (Procedures that 
contain other procedures are 


sometimes called supraprocedures.) 

Each procedure is thus a self- 
contained module, and you can 
make revisions without having to 
redo large portions of completed 
work. Instead you can modify sub¬ 
procedures or simply add on new 
ones. In the program shown here, for 
example, you could add a proce¬ 
dure to make the computer play a 
tune after each pickup without dis¬ 
rupting the procedures that let you 
play against another player. 











The subprocedure TO PLAY is also 
defined in terms of other subprocedures: 
TELLPLAYER, which will give the name 
of the next player; GETNUMBER, which will 
ask how many sticks to take away; 
CHANGESTICKS, which will erase the num¬ 
ber of sticks specified in GETNUMBER; 
and WINNER, which will announce the win¬ 
ning player when the last stick is removed. 
The definitions of the subprocedures 
TO TELLPLAYER and TO GETNUMBER 
are shown on the screen at right. 



TO PLAY 
TELLPLAYER 
GETNUMBER 
CHANGESTICKS 

IF : REMAINING < 1 [WINNER STOP] 

PLAY 

END 


TO TELLPLAYER 

MAKE “PLAYER :PLAYERl 

MAKE “PLAYER! :PLAYER2 

MAKE “PLAYER2 :PLAYER CLEARTEXT 

(PRINT SENTENCE COK,] :PLAYER C 

OUR TURNt]> 

END 


TO GETNUMBER 

PRINT CHOW MANY STICKS WILL YOU PICK UP^ 
?] 

MAKE “NUMBER READCHAR PRINT .NUMBER 
END 


The subprocedure TO CHANGESTICKS 
erases sticks from the screen by telling the tur¬ 
tle to SETPC 0 STICK, meaning ''Use black 
(0) as the pen color (PC) to draw sticks." Us¬ 
ing black makes whatever the turtle draws 
invisible on the screen. STICK, a key proce¬ 
dure used in both CHANGESTICKS and 
DRAWSTICKS, is defined here. Last, defining 
TO WINNER will produce the name of the 
winning player. Save the game onto a file 
disk, under the filename gome. 


TO CHANGESTICKS 

MAKE “REMAINING : REMAINING - : NUMBER 
IF : REMAINING < 0 [MAKE "REMAINING 01 
REPEAT : NUMBER CSETPC 0 STICK RIGHT 90 ^ 
FORWARD 18 LEFT 901 
END 


TO STICK 
PENDOWN 

REPEAT 2 [FORWARD 70 RIGHT 90 FORWARD 
RIGHT 903 
PENUP 
END 


TO WINNER 

PRINT [AND THE WINNER IS ...3 

WAIT 100 

PRINT :PLAYER 

WAIT 100 

END 


With the game program saved, all you 
need do to play the game is load Logo into 
your PCjr, insert the file disk and call up 
the game by typing load "GAME. When the ? 
prompt appears, simply type PICKSTICKS. 

The program will show you the rules if you 
want them, and then will display the 
opening set of sticks as shown at right. 
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EDUCATION AND ENTERTAINMENT 


An Artful Approach 
to Learning and Fun 


With interactive software like this face¬ 
making program, even four-year-olds can 
get an introduction to the keyboard and 
to programming. The child selects various 
features to create a face, then animates it 
by typing a one-letter command such as w for 
wink, F for frown. At the next level, the 
computer makes the face make faces — smil¬ 
ing, winking, frowning in a given order; 
the child must remember the sequence and 
type the appropriate letters. 



Computer novices of all ages can use the 
program shown at right to create video art on 
a color monitor while also learning simple 
computer programming. Easy-to-remember 
commands, such as D for draw, R for right 
turn and E for erase, guide a delta-shaped 
cursor to draw and paint on the screen. 

The program also features a special mode of 
drawing that turns the single pointer into 
four pointers, enabling you to produce im¬ 
ages with four-way symmetry. 



For the first-time computer user, child 
or adult, graphics and animation 
programs offer an attractive combi¬ 
nation of practicality and fun, a way 
to learn the computer keyboard and 
basic concepts of programming al¬ 
most without realizing it. With simple 
one-key commands, you can pro¬ 
duce a picture by selecting items 
from a menu (above) or by creating it 
out of your own imagination. With 
several such commands, you can 
build a simple animation (top) or a 
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color chart. Many of the best pro¬ 
grams will grow with you, as you 
progress from one-step commands 
to more complex instructions. 

If you dream of remodeling your 
home or landscaping your yard, 
some graphics programs will let you 
design a project on the screen first. 
These programs easily produce the 
straight lines, right angles, curves 
and circles that enable you to draw 
floor plans or tree and shrub icons. 
Mistakes cost nothing to make and 


are easy to correct. For the business 
person, some graphics packages 
mix text and graphics to let you cre¬ 
ate precise charts and graphs. 

To find the best programs for your 
needs, consult any of the periodicals 
and journals devoted to hands-on 
software reviews. You should also 
talk to friends or check the software 
best-seller lists in computer stores. 













Pairing an Artist’s Pad and the PCjr 



staMp 


urrent c 


hrush 


to picture 
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Of the roughly half-dozen ways to 
create and handle graphic images 
on a computer video screen, the 
touch pad (above) is probably the 
most natural: Using it is as simple as 
drawing on paper with a pencil. 

Once attached to the PCjr sys¬ 
tem, the touch pad should be set on 
a hard flat area, with its work sur¬ 
face facing up. Making strokes on 
the work surface with a plastic sty¬ 
lus or your finger creates lines or 


broad strokes, not on the pad but 
on the computer screen. 

The best touch pads come with 
well-designed programs that offer 
a variety of commands. Typical 
commands let you draw freehand, 
execute and adjust precise geo¬ 
metric shapes, save a picture or call 
up a help menu. Some programs 
also offer patterns and colors that 
may be used to fill In, or '"paint," 
designated areas of the screen. 
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Programs for Productivity: 
Managing Your Home or Office 


Well-designed software packages are the tools that 
make your IBM PCjr into the nerve center of a highly 
efficient small office. Word processing programs can turn 
your computer into a supertypewriter and you into a 
speedier typist, versatile editor and champion speller. 
Electronic spreadsheets — programs patterned after 
ruled ledgers used by accountants — let you ask ''what 
if" financial questions: Once you have entered the math¬ 
ematical relationships between various financial ele¬ 
ments into the spreadsheet, you can experiment with al¬ 
ternate figures and the program will make all the 
recalculations for you. Some spreadsheet programs also 
allow you to turn numbers Into graphics, cutting the time 
needed to prepare high-quality charts and graphs from 
days and weeks to hours or minutes. Data base man¬ 
agement systems can help you store and keep track of 
entire tiling cabinets full of information — and find any 
individual item in a trice. 

For each type of application, software can range from 
the basic to the elaborate — with price tags to match. 
Finding the best software for your needs takes a bit of 
homework on your part. If you are thinking about pur¬ 


chasing a program to help you at tax-filing time, tor ex¬ 
ample, make sure that the manufacturers have a reason¬ 
ably priced plan tor updating your software each year. 
There are also versatile programs, called integrated soft¬ 
ware, that offer more than one application within a pro¬ 
gram. But beware of inflated claims; sophisticated fea¬ 
tures found in Individual software may be sacrificed to 
save memory space in an integrated package. 

Equally important is whether the software is easy to 
learn and use. Pay close attention to the documentation, 
or written material, that comes with the program, and to 
onscreen aids, if any. Good software requires thousands 
of hours of programming time to create, but you should 
not have to spend thousands of hours mastering Its com¬ 
mands and options. See the software demonstrated and 
try it out yourself before purchase. For some applica¬ 
tions, you will need additional memory, tor which you will 
have to install an expansion board in your system unit 
(pages 98-99). Finally, the application program must use 
the operating system of your PCjr; you may have to copy 
command and control programs from your DOS disk 
onto the application disk in order to make It self-loading. 


On instructions from the computer, a 
printer puts out a paper, or hard, copy of an 
accountant's worksheet created by a spe¬ 
cial program called a spreadsheet. With the 
help of similar application programs, you 
can do many jobs, such as financial planning, 
formerly left to specialists. 
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PROGRAMS FOR PRODUCTIVITY 


Writing and Editing 
Electronically 


With a typewriter, any changes to this let¬ 
ter — the spelling corrections, word substitu¬ 
tions and format changes marked in 
red — would require you to retype the entire 
letter on a clean sheet af paper. Further 
mistakes would have to be corrected on the 
new sheet — or in yet another retyping. 

With a word processing program, the docu¬ 
ment is drafted and corrected on the com¬ 
puter screen lopposite); not a word is commit¬ 
ted to paper until the entire letter is ready. 


L2lFairvi 
Ll^wn, C 


Ms. Jensen 
Accounts Dept. 


15112lFairvtew Avenue 
Small^wn, Ohio 45227 





Dear Ms. Jensen: 

\ 1 have just received my Fe^ary bill, payable b¥ March 20. I note 
that you have still not deducted an amount to cover the return of a 
purchase amounting I 


store at Summerfield Mall on December 


$99.79 made.at Wolf and Ramson's department 
21, i9^r 


mate o 


The purchase was male on account number 015-466-621-2-1. 


Attached is a second copy of the credicvslip which I received when 
I returned the goods on December 29, 1983Please refer to my letter 
of January 31, 1984 on this same subject ^ At(.1 iiJrLa. 

Yours truly. 


L. A. Thompson 


Bob Scarfe 
Sports Dept. 

Wolf and Samson 
Summerfield Mall 
SummerfiA^l, Ohio 45529 


The PCjr adapts readily to use as an 
electronic typewriter, one of its most 
valuable functions. With word proc¬ 
essing software and a printer, you 
can create documents as casual as a 
shopping list or as complex as a 
business report or book manuscript. 
Any word-processing software will 
equip you to edit, format, store and 
retrieve your text. 

To turn out sophisticated reports, 
however, complete with page head¬ 
ings, underlining, footnotes and 
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aligned tables, you will need more 
advanced software. To send form 
letters requires a program that com¬ 
bines a list of names and addresses 
with a letter file, and then prints the 
same letter for different recipients. 
But elaborate programs may be diffi¬ 
cult to master. When shopping, look 
carefully at onscreen aids, or menus; 
these can be so clear that they prac¬ 
tically lead you by the hand — orthey 
can be cryptic and confusing. 

In some programs, the menus oc¬ 


cupy a constant portion of the 
screen, providing a handy list of keys 
for various commands; in others, the 
menus may be called up when need¬ 
ed. A formatting menu, for example, 
might list the commands to change 
margin settings and linespacing. A 
menu for manipulating blocks of text 
might tell you what commands to use 
to incorporate material from one file 
into another, to mark text you wish to 
delete or move (opposite) or to save 
the file you are working on. 











Metropolis. OHIO 455434 

Re. Account No. 015-466-621-2-1.4 

4 

4 

Dear Ms. Jensen: 4 

4 

4 

I have Just received nv Febuary 
hill, payable by March 20. 1 note that 
you have still not deducted an aMount 
to cover the return of a purchase 
aMountiny to $99.79 nade at Uolf and 
SaMson's departMent store at 
SuMMerfield Mall on DeceMber 21. 1983.4 


Further editing then corrects spelling er¬ 
rors, and marks the second paragraph for 
erasure. Some programs let you retrieve 
erased text if you change your mind. 


Press ESC to go to nenu 


Initial editing indents paragraphs and cor¬ 
rects typos. Screen icons display program 
options, and the box at lovA/er right shows the 
completed document as it would print out 
on standard 8V 2 -by-11 -inch paper — useful if 
you are editing on a 40-character screen. 




Paint the text by »%oving the cursor. 

Press ENTER to erase the text. 
Press ESC to cancel. 


Paint the text by Moving the cursor. 

Press ENTER when you finish painting 
the text. 

Press ESC to cancel. 


In continued refining of the text, special 
Instructions designate an important sentence 
to be underlined, a feature of many word 
processing programs. The cursor has also 
blocked out another sentence in order to 
move it to a different part of the letter. 


The marked sentence has been moved 
and the text is instantly reformatted. Most 
programs allow you to shift designated 
text by moving the cursor to the new location 
and giving the insertion command. With 
editing complete, the letter is ready to print. 


costing $99.79 wade at Uolf and 
SaMson’^s depaz^tMont stoz^e at 
SuMMepfield Hall on X>eceMber 21. 1983.4 

4 

Please nefer to My letter of 
January 31.1984 on this saMe subject. 
Attached is a second copy of the credit 
slip which I received when I returned 
the goods on DeceMber 29. 1983, Just in 

case My first letter has gone astray. 4 

4 

4 

4 

Vours truly,4 





■" [exi 

IT 


J 
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PROGRAMS FOR PRODUCTIVITY 


Data Base Managers: 


Electronic File 
Cabinets 


Data base managers can help you orga¬ 
nize large quantities of information for stor¬ 
age on, and quick retrieval from, cassette 
or disk. The information is stored in data files, 
which are subdivided into forms and 
fields. Fields are categories of information 
with labels such as STOCKNUMBER or tele¬ 
phone. A collection of related fields makes up 
one form; all forms in a file have the same 
fields, holding different information. If you 
designate one field as the key, you can 
arrange forms in alphabetical or numerical 
order, or tell the computer to search other 
files for additional information. 



FILES 

INVENTORY 


FORMS 


FIELDS 


GOODS 
UNIT SIZE 
CO-OP LIST 
FIRMNAME 
UNIT PRICE 
STOCK NO. 


SUPPLIERS 


FIRMNAME 

ADDRESS 

TELEPHONE 

GOODS 

DELIVERY 

DISPATCH 


MEMBERS 


NAME 
ADDRESS 
TELEPHONE* 
ACCT. NO. 
TRANSPORT 
CAR SIZE 









With a data base system and an 80- 
column display monitor, you can 
transform the PCjr into an electronic 
filing cabinet capable of maintaining 
records for a neighborhood food co- 
operative, compiling results of a 
community survey or keeping an in¬ 
ventory of acquisitions for a serious 
collector. Far more powerful than 
any traditional filing system, howev¬ 
er, a data base manager not only 
stores and retrieves information with 
extraordinary speed, but it sorts 
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through and presents whatever por¬ 
tions of it you request. 

You enable the PCjr to perform 
these feats by entering information in 
distinct categories on a form (some¬ 
times called a record), which you de¬ 
sign. If you use your data base to 
maintain your Christmas mailing list, 
for example, the form you design for 
the file might include the following 
entries: NAME, ADDRESS, CITY, STATE, ZIP 
CODE and TELEPHONE NUMBER. Each 
entry is known as a field; all of the 


forms in a file have identical fields. 
The best data base systems make it 
easy to restructure and edit your files 
and to add, delete, move or change 
a field when you wish. 

A typical program may provide for 
up to 80 characters per field and up 
to 254 characters per form. A total of 
2,200 simple forms, divided among a 
number of files, can be stored on a 
320K disk. However, you can keep 
each file on a separate disk, to leave 
room for expansion. 





















The fields on this inventory form used by a 
food co-op include the name of o firm selling 
oranges, the quantity available and the 
price. Using such information stored in your 
computer, you can shop for the best buy 
on oranges for the co-op. First, you direct the 
computer to search for '"Oranges" in the 
DESCRIPTION field of all forms in the Inventory 
file. The appropriate records will appear 
on the screen, one by one. 



You might then want to find out which of 
the firms supplying oranges will also deliver 
them. You can instruct the computer to 
search the Suppliers file for two pieces of in¬ 
formation: "Citrus Fruit" in the GOODS field 
and "Y" — for yes — in the delivery field. By 
comparing both cost and delivery infor¬ 
mation from your files, you can find the best 
supplier for your order. 


W Firmname; 

Goods: Citrus Fruit ^ 

1 Contact: 


Address: 

Delivery: Y 


Dispatch: 

Telephone: 

1 .-. 

Firsicode: 

. i 


File: Suppliers Retrieve Spec Page 

F-5 Date F-6 Time F-10 Continue 



If no citrus supplier offers delivery in time for 
your needs, you can look for another so¬ 
lution. By directing the computer to search the 
food co-op's Mennbership files, keying on 
the CAR SIZE and transport help fields highlight¬ 
ed on the form retrieved at right, you 
could find a co-op member both equipped 
and available to pick up the order. 


Y Name: Mary and Michael BROOKS 


1 Address: 34 Evans Court 


Rolling Road 


' SAalltown, 


OHIO 45333 



Account No: 32 

Telephone: 614-555-9787 


No. in household: 5 

1 .... 

Basics: Y 

. 1 
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PROGRAMS FOR PRODUCTIVITY 

Easy Recalculation 
with Spreadsheets 



Computer screens overlaid on a paper worksheet (above) illustrate the window 
effect of o spreadsheet program. Unlike a paper version, the electronic model 
con hove hundreds of columns and rows without growing impossibly unwieldy. 
By scrolling or by using direct Go to commands, you con coll any section 
of the worksheet into view on your screen. 


A spreadsheet program lets you 
build a model of the accountant's 
traditional worksheet on your com¬ 
puter screen. You can use such a 
program to prepare budgets, to re¬ 
cord expenses, to compute taxes, to 
manage your stock portfolio. 

Like its paper counterpart, the 
electronic model is essentially a 
blank page divided into rows (usual¬ 
ly numbered, from top to bottom) 
and columns (usually lettered, from 
leftto right). Columns and rows inter- 
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sect to form cells, which are identified 
by their coordinates. An electronic 
spreadsheet can have more than 
10,000 separate cells. The cells can 
hold different types of information: 
text, such as labels for columns and 
rows; numbers; and instructions in 
the form of mathematical formulas. 

Formulas can be simple, such as 
an instruction to add all the numbers 
in a certain range of cells and put the 
total in another cell; or complex, such 
as an instruction to perform a given 


calculation if o specified condition 
exists. Once the formula is entered, 
any changes in the cells it uses in its 
computations automatically pro¬ 
duce changes in all cells where the 
formula was applied. With a spread¬ 
sheet program, such a change takes 
only a few seconds, instead of the 
hours it might take by hand. This lets 
you try different "what ifs," to see 
how variations in one area, such as 
monthly income, affect the numbers 
in the rest of the spreadsheet. 











































A typical spreadsheet screen displaying a 
projected household budget reserves one 
or more lines at the top for display of 
program-related information. The top line 
identifies the cell — N19 — where the cursor is 
located; (v) +M19 indicates that the pro¬ 
gram has entered a value determined by pre¬ 
vious instructions — in this case, the value 
from cell Ml 9. The next two lines show your 
command to move the cursor to cell J12 
without scrolling the screen. 


A formula instructs the computer to dis¬ 
play the result of a calculation that uses fig¬ 
ures from other cells. At the top of the 
screen at right, the program information tells 
you that the highlighted figure in cell P20 is 
the sum of all the values in cells C20 through 
N20. A tally of actual expenditures in Col¬ 
umn P reveals that an unexpected increase in 
house repair and medical expenses (add¬ 
ed up in PI 9 and P20) have thrown your pro¬ 
jected budget into the red. 


A convenient feature of most spreadsheet 
programs is the split screen, which lets you 
view different parts of your worksheet 
simultaneously. You can change material in 
one place and almost instantly see the 
effect elsewhere. By reducing your April IRA 
payment and lunch expenses all year, as 
displayed on the left half of the screen, you 
will get the beneficial effect — a balanced 
budget — that appears on the right. 
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Computer Communications 


The potential of your PCjr is greatly increased by its ability 
to 'Talk" with other computers, using the same telephone 
network that you ordinarily use for voice communica¬ 
tions. Electronic information transfer can be faster than 
mail and cheaper than messenger. 

The advent of technology that adapts telephone lines 
for rapid data transfer means that your PCjr can be linked 
to many different types of computers, perhaps thousands 
of miles away. And the PCjr can draw on the capabilities 
of those remote computers to do jobs it could not do on 
its own. For instance, your PCjr can talk with mainframe 
computers that control huge data bases, which you can 
read and use for your own purposes. You can do re¬ 
search in a specialized data base such as a computer¬ 
ized law library or an electronic newspaper. 

An easy way to get access to a variety of data bases is 
to subscribe to a commercial information service, a com¬ 
puter network that draws on the facilities of a number of 
data bases. After making the phone link with the service, 
you can leaf through its menus electronically until you 
reach the subject you want to work on, then track down 
the specific items that interest you. You can even set up 


A modular phone lack, like the kind that 
lets you unplug a telephone, allows you to 
plug your PCir into the telephone network. 
The iack is attached by a cord to a direct- 
connect internal modem, which translates 
the electronic pulses of computer-encoded 
data into signals that can be sent through 
the phone lines to another modem. That mO' 
dem, in turn, converts the telephone sig¬ 
nals into pulses intelligible to its computer. 


your computer to record this information, as hard copy 
from your printer or as a disk tile. 

Research data bases aren't the only offerings of an 
information service. Some have a wide variety of fea¬ 
tures, from movie reviews to constantly updated news 
services. In some cities, you can even get restaurant 
menus and theater schedules through an information 
service. And several services have facilities that let sub¬ 
scribers communicate with each other, by notices posted 
on electronic bulletin boards, by individually addressed 
messages, or even by direct conversations in which 
words entered at one keyboard may appear on a moni¬ 
tor hundreds or thousands of miles away. 

But you don't need an information service to conduct 
direct communications. Any two personal computers can 
be set up ta talk to each other over the telephone lines; 
you can send reports from office to office, or electronic 
mail from city to city. Some computer owners even use 
their equipment to set up small-scale bulletin boards. 
Whatever the aim of your communications, you will find 
a vast pool of computerized information available to 
you — quickly and easily. 
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COMMUNICATIONS 


Installing Devices 
for Telephone Hookups 



Before installing the internal modem adapter card, first unplug the 
system unit. Allow the computer to cool for five minutes before remov¬ 
ing the cover. Place a flat screwdriver into one of the three slots at 
the top of the back of the system unit and twist; repeat at the other 
slots. Lift the cover up and away from the front of the system unit. 


A conversation between two people 
is based on implicit rules that enable 
them to understand each other. The 
rules include using speech to com¬ 
municate, speaking the same lan¬ 
guage, and taking turns doing the 
talking and listening. 

Computers need similar rules to 
communicate, but because they are 
much less flexible than people (they 
can't use slang, for example) their 
rules must be more precise. To en¬ 
sure that data transfer can occur 
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without garbling of messages or 
damage to equipment, computer 
manufacturers have developed an 
international communications stan¬ 
dard, governing everything from the 
meanings of electrical codes to the 
shapes of cable connectors. 

The standard also governs the 
operation of a modem (a short form 
of modulator-demodulator), a de¬ 
vice used to translate the electronic 
pulses understood by the computer 
into signals understood by the tele¬ 


phone system, and vice versa. 

With the PCjr, you may use either 
an internal modem /'abovej, which tits 
into one of the computer's expansion 
slots, or an external modem (box, op¬ 
posite), which plugs into the serial 
port at the back of the system unit 
through an adapter cable. An inter¬ 
nal modem trees the serial port for 
other devices such as a printer, and 
has other useful features: It can dial a 
number automatically and answer 
calls coming in to your computer. 




















To plug the internal modem into the system slot, position the mo¬ 
dem with its multipin connector directly above the system slot, and the 
smaller two-pin connector above the two-pin plug. Press the card 
firmly in place. Be sure the rear of the card goes into the rear guard. 



To replace the cover, place it atop the system unit and slide it for¬ 
ward until it is flush with the front of the system unit. Press down on the 
rear of the cover until it snaps into place. To complete the modem 
installation, plug one end of the modem cable into the connector slot 
marked M on the back of the system unit. Plug the other end into a 
standard modular telephone wall jack. 


A Modem for 
Several Machines 

An external modem — a separate 
device that connects the PCjr to 
phone lines — is generally less con¬ 
venient than an internal one be¬ 
cause it uses the computer's serial 
port, requiring that you disconnect 
the printer. But if you have several 


computers, it is more economical to 
let them share one modem. 

External modems may be direct- 
connect (plugging into modular 
jacks like an extension phone) or 
acoustic. An acoustic modem (right) 
needs no cable connection to the 
computer: The phone's handset fits 
into the modem's rubber cups. This is 
useful if you plan to travel with your 
PCjr and may be calling from phones 
without modular jacks. 



An acoustic modem turns computer signals 
into audible tones and sends them via a 
telephone receiver in the modem's cradle. 
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COMMUNICATIONS 


Instructions 
for Linking 
Operations 


The blue arrow shows how you begin 
communications between your PCjr and o 
distant computer. Load a communications 
program into the PCjr through your disk drive. 
The program asks you to provide input at 
the keyboard about communications set¬ 
tings, which the computer uses to estab¬ 
lish a link. The modem transmits signals over 
phone lines to a remote computer. The 
red arrows indicate the reverse flow of infor¬ 
mation, through phone lines and modem 
into the computer, where you can save data 
to disk or printer. Incoming data is dis¬ 
played on your monitor as it is received. 



Even with a modem in place, you can 
communicate with other computers 
only with proper instructions. A com¬ 
munications program tells the PCjr 
how to organize its internal oper¬ 
ations and how to set up an external 
link. In effect, this software turns your 
PCjr into a remote terminal of an¬ 
other computer and directs the com¬ 
munications process. 

To assure that both computers will 
be speaking the same language, 
you specify protocols, such as baud 
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rate (transmission speed), data bits 
and the type of parity checking to use 
in error detection. You also specify 
whether information will flow in both 
directions simultaneously (full du¬ 
plex) or in one direction at a time 
(half duplex). 

A communications program en¬ 
ables your PCjr to perform a variety 
of tasks: Your machine can send and 
receive messages at the moment 
they are typed, save incoming infor¬ 
mation on a disk or send information 


that has been stored on a disk. Such 
a program can give you access to a 
mainframe computer, which will en¬ 
able you to use programs too large 
to be stored in the PCjr's memory. 

Communications programs far the 
PCjr range from the sophisticated — 
and costly — to the simple. The Sam¬ 
pler disk that comes with your PCjr 
contains a simple communications 
program that lets you immediately 
link up with other computers and with 
information services. 






































Communications software, like the simple 
program provided on your PCjr Sampler disk, 
directs the process of communicating with 
0 distant computer. An options menu (right), 
asks you to provide information to ensure 
that your PCjr will be using the some rules, or 
protocols, os the equipment at the other 
end of the phone lines. 




After you've set protocols, another menu 
(right) asks you for the phone number of the 
computer you want to call. First type an 
access code — which may be a number to get 
an outside line, an area code, or both. 

Type P after each code so the computer will 
pause 10 seconds for the dial tone. Then 
enter the phone number of the mainframe, 
personal computer or information service. 



Note: 


To difkl an outside line and 
pai-ise -for- a dial tone, type 
access code, then P, 
then the phone number- 



The communications program will instruct 
the computer and modem to dial the distant 
computer. Your PCjr will let you know 
when you've established a link with another 
computer by displaying a "Connected" 
message. It will tell you if it has failed to reach 
the other computer, by giving you a 
"Busy" or "Unsuccessful" message. 
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COMMUNICATIONS 


Commercial Services: 
Information a la Carte 


In the first step of a typical procedure for 
logging on, or tying into a commercial infor¬ 
mation service Irightj, you coll the ser¬ 
vice's number and make a telephone con¬ 
nection. After the link is confirmed with 
messages such as "Connected" and "OK", 
hold down the Control key and press c. 

You will then be asked for your ID and pass¬ 
word. To ensure that your password re¬ 
mains private, it is not displayed on the moni¬ 
tor screen when you type it. 



Once you have logged on to an informa¬ 
tion service, a main menu IrightJ lists an array 
of services. Each menu entry leads to an¬ 
other, more specialized menu. Entering 2, for 
example, will bring up a listing of financial 
and business services; typing 1 will lead to 
another menu, listing home services. 



5 User Information 
6 > Index 


Enter yoiar selection number, 
or H -for more information. 



One of the most fruitful uses of your 
PCjr is in linking up with a commer¬ 
cial information service such as The 
Source or CompuServe. Easy to use, 
these services place an enormous 
amount of data at your disposal. 

Most information services work in 
similar ways. You must pay an initial 
fee (applications are available 
through computer dealers and by 
mail), and the service then assigns 
you an identification number and a 
password, which give you access to 
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the system. The information service 
bills you for the amount of time you 
are connected, at rates that vary ac¬ 
cording to the time of day. And of 
course, you pay the telephone com¬ 
pany at standard rates for the use of 
the phone lines. If there is no direct 
telephone number for an information 
service in your area, you may be 
able to use a specialized communi¬ 
cations network that allows you to 
establish a link to a distant service 
with a local phone call. 


The Source and CompuServe not 
only give you access to a vast array 
of information instantly, but also offer 
programs that let you ''chat" with 
other users and hold electronic 
meetings. You may, for example, 
choose to join a special-interest 
group, or SIG, of PCjr users. You can 
then leave messages, read the mes¬ 
sages left by other SIG members, 
and participate in specially sched¬ 
uled on-line conferences, which of¬ 
ten feature guest "speakers." 














The home-services menu Iright) presents a 
list of even more specific services. Choosing 
HOME SHOPPING/BANKING would bring up 
still another list, which would allow you to leaf 
through an electronic catalogue and or¬ 
der merchandise, or transfer funds from a 
checking to a savings account. Once 
you're familiar with the menus, you can use 
abbreviated commands to go directly 
to the service you want. 


CompuSer- ve 
HOME SERVICES 



P3ge HOM- 


News/Mea'tfier / Sportis 
Reference Library 
Communicafions 
Home Shopping/Banking 
Discussion Forums 
Games 
■7Education 
-S Home Management: 

Travel 

10 Entertainment 


L a « 
o r 


menu page. Key digit 
for previous menu. 




Saving Time with 
Special Utilities 

Commercial information utilities 
provide access to a world of infor¬ 
mation and services. Networks 
such as CompuServe and The 
Source offer an assortment of ser¬ 
vices through one centralized 
source. Other utilities are more 
specialized, providing such ser¬ 
vices as bibliographic searches of 
professional journals, or detailed 
information on commodity prices. 

These services can save you 
substantial time and money, by 
eliminating transportation costs 
and reducing the time you spend in 
libraries. But user fees can quickly 
add up. To keep your costs rea¬ 
sonable, be familiar with user 
guides before you log on, and 
have a good idea about what part 
of the service you want to use and 
what information you are seeking. 
Plan to use the service during 
evenings or weekends, when 
hourly access charges are lower. 

The following is a brief guide to 
the range of information and ser¬ 
vices available through your PCjr. 


NEWS AND WEATHER: Electronic 
newspapers range from up-to- 
the-minute headline services to 
complete newspapers, including 
everything from weather and 
sports to astrology. 

FINANCIAL INFORMATION: You 

can survey constantly changing 
stock and commodity prices, re¬ 
view data on thousands of corpo¬ 
rations, or research current eco¬ 
nomic indicators. 

ON-LINE SEARCHES: On-line refer¬ 
ence services let you leaf electroni¬ 
cally through reference materials. 
You can search the New York Times 
index, or an entire encyclopedia, 
or hundreds of professional and 
trade publications. 

ELECTRONIC PUBLISHING: You 

can call up special editions of your 
favorite magazines, or electroni¬ 
cally ''publish" your own poems, 
articles, newsletters and books for 
other users to read. 

SHOP-AT-HOME SERVICES: Elec¬ 
tronic catalogues allow you to do 
your shopping at home. You can 


compare prices, place orders and 
charge your purchases using a 
credit card number. 

BANK-AT-HOME: Computer bank¬ 
ing speeds transactions, letting 
you transfer funds between ac¬ 
counts or instruct the bank to pay 
bills from your account. 

TRAVEL INFORMATION: You can 

check airline schedules, make res¬ 
ervations, and order and charge 
your tickets in much the same way 
a travel agent does. 

ENTERTAINMENT: Special listings 
give you access to movie and the¬ 
ater reviews, restaurant menus, 
and ticket-ordering facilities. Or 
you can play multi-user strategy 
games, chat with friends on a com¬ 
puter version of citizens-band ra¬ 
dio, read your horoscope, or use a 
matchmaking service to line up a 
Saturday night date. 

ELECTRONIC-MAIL: These services 
save time and eliminate messen¬ 
ger costs by transferring memos, 
contracts, or letters directly from 
computer to computer. 
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Programming in BASIC: 
Home-grown Software 


The job of programming — writing the software that 
makes a computer so versatile — is often regarded as a 
task best left to highly trained professionals. But your PCjr 
is equipped with a programming language, called BA¬ 
SIC, that makes it possible for you to write your own 
programs, and learn about programming in the process. 

BASIC, like most programming languages for non¬ 
experts, is what is known as a higher-level language. 
Such a language is itself a program that translates easy- 
to-remember commands — source code — into the ma¬ 
chine code that the computer understands. BASIC, which 
was designed as an instructional language, makes it 
possible for you to try out different ways of programming 
and see the results quickly and easily. 

The version of BASIC installed in your PCjr is an inter¬ 
pretive language. Whenever you run a program, BASIC 
must translate each line of source code into machine 
code, then execute it, before going on to the next line. 
While this slows the running of programs, it allows you to 
detect and correct problems as you develop a program: 
If it is not doing what you want it to do, you can read and 
revise the source code. Another type of higher-level lan¬ 


guage, called a compiler language, translates source 
code into machine code as it is written. Because com¬ 
piled programs are already in machine code, they run 
more quickly than interpreted programs, but the source 
code is no longer available for examination and change. 
To combine the advantages of each type, you can use an 
optional addition to the BASIC package called the BA¬ 
SIC compiler. This program takes the source code of a 
program that you have developed with the interpreter 
and uses it to make a compiled program for actual use. 

In this chapter you will be introduced to some of the 
most fundamental commands in BASIC, which let you 
begin to write simple programs yourself. You should try 
the examples on your own computer, and try out vari¬ 
ations of the examples as well, to get an understanding 
of the concepts they illustrate. You will also find the BASIC 
manual supplied with your computer to be an excellent 
reference source as you explore the power of the lan¬ 
guage. And if you decide you want to go on, you will 
discover that the popularity of BASIC has given rise to 
many books and courses that can take you as far into the 
study and use of the language as you want to go. 


A tew lines of BASIC program code moke 
the PCjr display this colorful pattern on the 
monitor. The numbers at the beginning of 
each line are the backbone of the program; 
BASIC reads the lines in numerical order, 
executing the instructions on each line before 
going on to the next. When this program 
runs, the shapes within the pattern are deter¬ 
mined by numbers typed at the keyboard 
in response to a question mark on the screen. 
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PROGRAMMING IN BASIC 


Two Modes for Working in BASIC 


Esc 1 !2@3 #4 $5%6A7 48 *9 (0 )- — = + Lckspace Fn 




When you start up in BASIC, the first lines on the screen tell you which version of 
the language you are using. The Ok prompt indicates that the BASIC inter¬ 
preter is ready for your instructions. BASIC lets you enter several of the most com¬ 
mon instructions, such as list, load, save and run, with just two keystrokes. 

The blocks at the bottom of the screen show the key words assigned to the func¬ 
tion keys at the top of the keyboard. You can clear these key indicators from 
the screen with the command key off; entering key on brings them back. 


Cassette BASIC and Cartridge BA¬ 
SIC, the versions you can use with 
your PCjr, differ in their capabilities 
(pages 26-29} but not in the way you 
interact with them. Cartridge BASIC, 
which lets you store and retrieve pro¬ 
grams on disks, is used in the exam¬ 
ples In this chapter. To use Cartridge 
BASIC with a disk, first put a disk that 
has the DOS command files (page 
32} into the disk drive, then start up 
by turning on the computer or insert¬ 
ing the BASIC cartridge into the slot. 
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Both versions of BASIC distinguish 
between immediate and deferred 
operation. If a BASIC line starts with 
a character that is not a numeral, the 
BASIC interpreter understands that 
immediate action is required as soon 
as you strike the Enter (<J) key. It 
will analyze your line to see if it 
makes sense (to BASIC); it will then 
carry out the instructions and return 
with the Ok prompt, or tell you that 
the line doesn't make sense, with the 
message "Syntax error." 


If a line starts with a numeral, BA¬ 
SIC understands that you want It to 
tile that line under that number, tor 
later use. When BASIC Is operating 
like this, it is said to be in deferred, or 
programming, mode (a program is 
in fact a set of these deferred instruc¬ 
tions, filed in memory and executed 
in numerical order). When you enter 
a program line, BASIC assumes you 
intend to continue, and waits tor the 
next line to be entered without giving 
you the Ok prompt. 




















































When you are operating in DOS, typing 
basic causes the computer to turn control 
over to the Cartridge BASIC interpreter. 

The BASIC cartridge must be in place or you 
will see the message "Cartridge required " 

If you do, insert the cartridge into the slot. In 
either case, you will next see a screen 
similar to the one shown on the opposite 
page. In order to return control to DOS 
from BASIC, type system <-l. 



Every time you start using BASIC, the lan¬ 
guage is in the command, or immediate, 
mode. This means that any instruction you 
enter will be carried out immediately, as 
shown at right. When you enter the line key 
off the BASIC interpreter immediately car¬ 
ries out the statement, turning off the key indi¬ 
cators at the bottom of the screen and 
then signaling with the Ok prompt that it is 
ready for your next instruction. When you 
enter the line print "Hello there" BASIC dis¬ 
plays Hello there but not the quotation 
marks. When you enter width 80, BASIC 
changes the display to 80 characters per 
line, as shown on the screen below. 



To change over into the programming mode, 
simply start a line with a number. When 
BASIC reads a number at the beginning of a 
line, it knows that it must store the instruc¬ 
tions on that line and carry them out later, 
when you give it the run command. When 
you press the Enter key at the end of a line, 
BASIC waits for another line number or an 
instruction. On receiving the command run, 
BASIC executes all of the lines it has 
stored up, in numerical order of line numbers. 
In this case there is only one line, and BA¬ 
SIC displays the same message that it earlier 
displayed in the immediate mode. 
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PROGRAMMING IN BASIC 


Telling BASIC 
What You Mean 


As you enter a program, BASIC keeps it 
in the computer's internal memory. You con 
view the program that is in internal mem¬ 
ory at any time, using the list command 
(screen, right). To store o program on disk, 
use the save command; give the program a 
name and be sure to enclose the name in 
quotation marks. To clear a program from in¬ 
ternal memory, enter new. As shown on 
the screen at right, a list command shows no 
program remaining in internal memory af¬ 
ter the new command is executed. 



save "greeting” 
Ok 


net* 

Ok 

list 



To move a program from a disk into inter¬ 
nal memory, use the command load followed 
by the program name in quotation marks. 

You can use the list command to see the con¬ 
tents of the program, then use the run 
command to see it executed. If you want to 
empty the screen, enter the command cIs. 
Everything on the screen will disappear, and 
the Ok prompt will appear in the upper left 
corner. The cIs command affects only the 
screen, leaving the contents of the internal 
memory intact, as you can verify by using list. 



Like most interaction with a comput¬ 
er, programming in BASIC requires 
that you be very precise in formulat¬ 
ing your instructions. Each line in a 
program is made up of two sorts of 
elements: key words and special 
characters that have specific mean¬ 
ings in BASIC (chart, above, right), 
and the ordinary letters and numbers 
of the data the program processes. 
These elements must be assembled 
according to the system (called syn¬ 
tax) that the BASIC interpreter under¬ 
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stands. When BASIC encounters in¬ 
structions that do not make sense 
within its syntax, it responds with the 
phrase '"Syntax error." 

BASIC has a wealth of other mes¬ 
sages to tell you when you have 
made what It considers to be a mis¬ 
take; they are listed, with their mean¬ 
ings and suggested remedies, in an 
appendix to the IBM BASIC manual. 

When you are in immediate mode, 
BASIC reads each line as you enter 
it, and responds with an error mes¬ 


sage if the content of the line is incor¬ 
rect. When you enter lines in the pro¬ 
gramming mode, on the other hand, 
the BASIC interpreter does not check 
the syntax until you run the program. 
Then BASIC will tell you what the er¬ 
ror is and the number of the line 
where it occurs, and give you the op¬ 
portunity to correct it on the spot. If 
you do correct it and the program 
works, remember to save the cor¬ 
rected program to disk; you hove al¬ 
tered only a copy of the program in 










Reserved Words and Symbols in BASIC 


II ri 

Characters inside quotation marks are proc¬ 
essed as data, not executed as statements. 


CLS 

Clears the screen of all previous display. 

Does not affect the program in memory. 


Separates statements or commands entered 
on a single program line. 


KEY 

Key off turns off the function key indicators at 
bottom of screen; key on turns them on. 

I 

Tells BASIC to execute the next statement 
without moving the cursor. 


SCREEN 

Sets BASIC for operation in one of its graphic 
or text modes. 

+ - 

Signs for addition and subtraction. The plus 
sign also acts to link two character strings. 


LET 

Assigns a value, or the product of a compu¬ 
tation, to a variable. 

*/ 

Signs for multiplication and division. 


INPUT 

Assigns values to variables from the 
keyboard. 

$ 

Indicates that the content of a variable is to 
be treated as a non-numeric value. 


GOTO 

Branches the program to a specified line. 

= 

Denotes equality in if.. .then statement; as¬ 
signs new value to variable in let statement. 


GOSUB 

Branches the program to a subroutine; 
return branches the program back. 

REM 

Tells BASIC that remainder of program line is 
a remark, not to be executed. 


IF.. .THEN 

Causes a stated procedure to be executed if 
a specified expression is true. 

RUN 

Starts execution of the program BASIC holds 
in memory. 


FOR.. .NEXT 

Causes the program to repeat a set of proce¬ 
dures for a stated number of times. 

STOP 

Causes program to stop execution. Cent 
causes program to resume. 


READ 

Assigns to specified variables a set of values 
drawn sequentially from data statements. 

LIST 

Displays a line-by-line listing of the program 
BASIC holds in memory. 


PRINT 

Displays specified expressions on the 
monitor. 

NEW 

Clears BASIC program memory; used before 
entering a new program from keyboard. 


LPRINT 

Sends specified expressions to the comput¬ 
er's printer. 

LOAD'' 

Brings a specified BASIC program from a 
disk into program memory. 


LOCATE 

Positions the cursor at the specified line and 
column numbers. 

SAVE" 

Copies the BASIC program currently in mem¬ 
ory onto a disk; program must be named. 


END 

Terminates program execution and returns 

BASIC to the immediate mode. 


This chart lists words and symbols with special meanings in BASIC. Each tells BA¬ 
SIC to carry out a specific task; if the task is inappropriate or impossible, a 
''Syntax error" message will appear. If you misuse a key word, but the program 
line still makes sense, BASIC will execute the line — with varying results. 


the computer's memory, not the one 
stored on the disk. 

You con reduce the occurrence of 
error messages by checking each 
line before you enter it. If you find on 
error, you con correct it by moving 
the cursor back to the point of the 
error and typing over it; the newly 
typed material will replace the old. If 
you wish to insert material in the mid¬ 
dle of a line, move the cursor to that 
point and press the Insert key; the 
cursor will change shape, and what¬ 


ever you type will be inserted while 
the original material moves to the 
right. If you don't catch an error until 
after you have entered a line, you 
can fix the entire line by simply retyp¬ 
ing it correctly, using the same line 
number. The BASIC interpreter will 
store the newly entered line in place 
of the line already stored in memory 
under that number. 

One feature of BASIC that makes 
it easy for the novice to use is that key 
words are usually self-explanatory. 


Some instructions, called com¬ 
mands, act on an entire program — 
to store or retrieve it from memory, to 
list its contents or to execute it. Other 
instructions, called statements, work 
within the program, controlling proc¬ 
esses that lead to the results the pro¬ 
gram is designed to produce. Many 
of the most common and useful com¬ 
mands and statements will be ex¬ 
plained in this chapter. 
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PROGRAMMING IN BASIC 


Getting Data 
from the Keyboard 


The /npDf statement causes BASIC to read 
values from the keyboard. Here, BASIC 
stores the value it reads in the variable 
named age. When you enter the line, BASIC 
responds with a ? prompt — indicating that 
you should enter a value from the keyboard. 
When you do so — in this case, typing the 
number 27 — BASIC assigns the number to 
the variable, age. The print statement in¬ 
structs BASIC to display the specified infor¬ 
mation — the value of the variable, age. 



A variable with a name like age can hold only 
numeric values. If you try to put anything 
else into such a variable, BASIC will tell you 
to start your input again. You can store 
letters in a variable if you have given the vari¬ 
able a name that ends with a $. This type 
of variable is called a string variable, and its 
content, which can be any combination of 
letters and numerals, is called a string. 



input agel 
? twenty-seven 
Ok 

print age$ 

twenty-seven 

Ok 




A variable is one of BASIC's most 
useful tools. BASIC uses variables as 
if they were file folders, each with its 
own name. You might store any val¬ 
ue in the variable, but to manipulate 
that value, you need only instruct BA¬ 
SIC to perform an operation on the 
variable itself. This means that one 
program line can be used to do the 
same thing to any number of values, 
as long as each value Is stored in Its 
turn under the same variable name. 

BASIC distinguishes between nu- 
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meric variables, which can hold only 
numbers, and string variables, which 
can hold any combination of letters 
and numerals. BASIC cannot use nu¬ 
merals stored in a string variable for 
mathematical computations, since 
BASIC understands the content of a 
string variable only as a list of alpha¬ 
numeric characters. 

You can name a variable almost 
anything that reminds you what is 
stored there. Do not, however, use a 
reserved word that has special 


meaning for BASIC, or it will respond 
with a "Syntax error" message. 

The most immediate way to assign 
values to variables is to use the input 
statement, which lets BASIC read 
keyboard data while a program is 
running. Keyboard input must be 
correctly structured; BASIC always 
expects the type and number of vari¬ 
ables specified in the statement and 
will respond to any variation with 
"?Redo from start." If you get that 
message, retype your input correctly. 







An /npt/^ statement can contain a prompt that 
you determine, so that when the program 
is run, BASIC can ask the person at the key¬ 
board for the specific information needed. 
When you use an /npuf prompt, it must be en¬ 
closed in quotation marks and followed 
by a semicolon and the name of the variable. 
The quotes do not appear when BASIC 
prints the prompt. To suppress the question 
mark when BASIC prints the prompt, use 
a comma instead of a semicolon. 



This short program incorporates /npu^ state¬ 
ments calling for first a string variable and 
then a numeric variable. The third program 
line tells BASIC to display a sentence us¬ 
ing both of the variables. Quotation marks 
are used in the pr/n/statement to surround 
nonvariable character strings — in this case, 
words — that you want to display. 


When you run the program, BASIC executes 
the lines in order, first prompting you to in¬ 
put your name; after you enter your name, it 
prompts you to input your age. As soon 
as that is entered, BASIC executes the next 
program line, displaying the sentence with 
the contents of the two variables filled in. 




L 
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PROGRAMMING IN BASIC 


Putting Values 
into Variables 


You can use a /ef statement to have BA¬ 
SIC assign a value directly to a variable. A let 
statement can assign a numeric value, a 
string value, or even the result of a computa¬ 
tion. In this example, xand yore assigned 
numeric values; n is assigned a value equal 
to the sum of x and y. BASIC automatical¬ 
ly computes the sum, which appears when 
you give the instruction print n. 



You can combine input ond /e^ statements to 
have BASIC perform calculations on num¬ 
bers that you enter at the keyboard. In this ex¬ 
ample, the variable myoge is defined by 
keyboard input; the variable older \s 
defined by a /et statement. Each time you 
change the value of myoge, the value of older 
changes correspondingly. 



print older 
29 
Ok 

input eyage 
? 43 



You can assign values to a variable 
from within a program by using a let 
statement. This allows you to take full 
advantage of the PCjr's computing 
power, since the value you store In 
the variable need not be simply a nu¬ 
meric or string value, but can instead 
be the result of a set of computa¬ 
tions. Thus the value of a variable 
might be the result of computations 
involving other variables; the expres¬ 
sions within a /ef statement can be as 
complex as your program requires, 
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provided they are in BASIC syntax. 

The arithmetic operators used for 
mathematical computations in BA¬ 
SIC (chart page 79) are similar to 
symbols used in algebra. But the BA¬ 
SIC equal sign ( = ) sometimes has a 
meaning quite unlike the algebraic 
one. In a /e^statement, this sign does 
not mean that the expressions on 
each side are identical; it means the 
value on the right Is to be stored in 
the variable named on the left. Thus 
the statement let n=n+l, impossible 


in algebra, has meaning for BASIC. It 
tells BASIC to take the old value 
stored in the variable n, add /, then 
store the sum in the variable n. 

Whenever you use numbers In a 
BASIC program, remember that BA¬ 
SIC does not understand the use of 
commas in numbers. If you type a 
number with a comma as input, BA¬ 
SIC will respond with "?Redo from 
start"; if you use a comma In a num¬ 
ber within a /e^statement, BASIC will 
respond with "Syntax error." 










The short program on the screen at right 
computes a minimum monthly installment 
payment, based on inputs of total cost 
and down payment. The /et statement assigns 
a computed value to the variable poy- 
ment. Notice the use of parentheses; BASIC 
performs the operations inside parenthe¬ 
ses, then those outside. Also note the use of 
the single quotation mark in line 30; it in¬ 
dicates that the remainder of the line is a re¬ 
mark, and is not to be executed. 



The /ef statement can also be used to as¬ 
sign a string value to a variable. You must en¬ 
close the string value in quotation marks; 
BASIC reads everything within the quotes, in¬ 
cluding spaces and punctuation marks, as 
part of the string. You can combine two 
strings by using the positive sign ( + ); BA¬ 
SIC executes this by appending the second 
string to the end of the first. 




You can use a /e/statement to assign the 
current date or time to a variable. The expres¬ 
sions date$ and time$coW up values from 
the PCjr's clock, which you set when you 
booted the DOS disk (page 33). These 
date and time values can be useful in many 
program applications to pinpoint the time 
when a particular procedure was performed. 


10 let d$ > dates 

20 let At = **InvoicB dated " 

30 let tt « "Aeount payable: " 
40 input "Invoice aeount"; cS 
50 print aS t dl 
60 print bS ^ c$ 
run 

Invoice aeount? $300 
Invoice dated 03-26-84 
Aeount payable: $300 
Ok 
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PROGRAMMING IN BASIC 


Making Decisions 
with If... then 


BASIC can be instructed to perform an 
action when a specified expression is true, us¬ 
ing the combination if. . . then. In line 30 
of the program at right, BASIC is told to look 
at the value assigned to the variable doz¬ 
en; if the value is greater than 200, then BA¬ 
SIC is instructed to print 'Too heavy." 

Note that BASIC displays the message only if 
the specified expression is true. 



You can expand the if. . . then construc¬ 
tion by using else to designate an alternative 
action if the specified expression is not 
true. Changing line 30 of the program as 
shown at left causes BASIC to print one 
message if the value of dozen is greater than 
200, and another message if the value of 
dozen is not greater than 200. 



Much of the work done by a pro¬ 
gram consists of comparing values 
and performing actions based on the 
results of each comparison. In BA¬ 
SIC, this instruction is the //state¬ 
ment, which usually includes the 
word then. The use of if. . . then In 
BASIC is similar to its use in English; 
for example, you might tell a child, "W 
the sky is blue, then go outside to 
play," or tell BASIC, "If b equals 2, 
then print b." But unlike a child, BA¬ 
SIC does nothing If the expression 
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proves false; thus, if the sky Is not 
blue, a child might still go outside, 
but If b does not equal 2, BASIC sim¬ 
ply goes on to the next instruction. 

Variations of the //statement make 
possible a range of comparisons 
and actions. You can give BASIC an 
alternative action to perform if the 
expression is untrue, by adding an 
else clause after the //statement 
(above, bottom). If you use the words 
and and o/'in the //statement, BASIC 
will test two or more expressions. 


and base its decision on the com¬ 
bined result. An equal sign In an if 
statement, unlike one in a /ef state¬ 
ment, does mean "is equal to." 

You can substitute goto for then in 
the //statement (opposite, bottom 
left), directing BASIC to branch to a 
specified line number if an expres¬ 
sion is true. Goto is useful In its own 
right; It can be used anywhere in the 
program without an //statement, to 
branch from the sequence of line 
numbers to any point in the program. 











le 


te«p 


input "Teaperature (centigrade)”; 

20 input ”Ii it raining (y/n)”; y$ 

30 if teep < 0 and Yf*"y'' then print "Freezing rain" 
run 

Teeperature (centigrade)? -3 
Is it raining (y/n)? y 
Freezing rain 
Ok 


run 


Teeperature (centigrade)? 4 
Is it raining (y/n)? y 
Ok 


L 
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The //statement can be used to have BA¬ 
SIC make a decision based on the truth of 
more than one expression. In this pro¬ 
gram, if both of the expressions specified in 
line 30 are true, BASIC displays the mes¬ 
sage ''Freezing rain." If either expression is 
not true, BASIC takes no action. ^ 



By substituting goto for then in an //statement, 
you can cause a program to branch to a 
specified line number out of the ordinary se¬ 
quence. In line 20 of this program, BASIC 
is directed to branch to line 30 if the value of 
ans is 4, and to branch to line 10 if the val¬ 
ue of ans is not 4. The program returns to the 
beginning each time the input differs from 
what you have directed BASIC to look for. 
When the expected input appears, the 
program displays the message "Correct." 


To have BASIC test more than one expression 
and perform an action if any one of the 
expressions is true, use or in the if. . . then 
construction. If either expression in line 30 
is true, BASIC displays the message "Not 
here, please." Only one expression in an 
if... or.. . then statement need be true for 
BASIC to perform the designated action, 
and three or even more expressions can be 
examined in one //statement. 


10 input "Do you saoke (y/n)"; antll 
20 input "Does anyone in your office taokt (y/n)"; 
30 if antl$«"y" or ani2l'«"y" then print "Not here, 
run 

Do you seoke (y/n)? n 

Does anyone in your office seoke (y/n)? n 

Ok 

run 

Do you seoke (y/n)? n 

Does anyone in your office seoke (y/n)? y 


ans2l 

please. 


Not here, please. 


Ok 


L 


J 


You can use //statements in successive lines 
to sift through a number of possibilities; if 
BASIC finds the expression in the first state¬ 
ment to be false, it ignores the rest of the 
line, goes on to the next line and performs the 
next test. This program is set up to return 
to the start unless the input response is n or N. 


you want to go in circles";ansi 
* or ansl*"Y" then print"Here we go";goto 10 
" or ansls‘"N" then print "Goodbye" else goto 10 

Do you want to go in circles? y 
Here we go 

Do you want to go in circles? x 

Do you want to go in circles? 37 

Do you want to go in circles? n 

Goodbye 


Ok 
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PROGRAMMING IN BASIC 


A Loop to Repeat 
a Set of Procedures 



When you develop any but the simplest 
program, it is useful to outline the procedure 
you have in mind before you try to write 
the BASIC source code of the program. This 
flow chart outlines the program on the 
screen at the bottom of the opposite page, 
breaking it into each of its steps from be¬ 
ginning to end, including the for. . . next 
loop inside the broken line. 

Note that the shapes used in flow charts in 
this book are similar to standard shapes 
used by most programmers. While your flow 
charts may not be as elaborate as this 
one, you should use the same shapes, for 
clarity when you read them later. 


A computer excels at jobs that call for 
repeating the same process many 
times. You can make use of this pow¬ 
er in BASIC by bracketing between 
two special statements—for and 
next —a procedure that you need to 
repeat; such bracketing causes BA¬ 
SIC to execute a loop, going through 
the same procedure as many times 
as you specify. 

A forstatement tells BASIC that it is 
to do a job a given number of times, 
as specified by the values assigned 
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to a variable in the statement. The 
variable in a forstatement is used as 
a counter; BASIC stores the initial 
value of the variable in memory, then 
executes the subsequent instructions 
until it reaches a nex/statement. BA¬ 
SIC then branches back to the for 
statement, adds the specified 
amount to the counter variable, and 
checks to see whether the value ex¬ 
ceeds the specified final value. BA¬ 
SIC repeats the loop until the value of 
the counter exceeds the final value; 


then it branches directly to the state¬ 
ment following the nex^ statement. 

The power of the for. . . next loop 
lies in the way it can process a differ¬ 
ent set of values at each repetition. A 
good example of its usefulness is in 
chart preparation (opposite, center 
and bottom). The loop might contain 
complex instructions for calculating 
and displaying data, but you would 
need to write the instructions only 
once, no matter how many lines 
were required to complete the chart. 






































The /or statement in line 10 of this program 
tells BASIC to assign an initial value of 1 to 
the variable greet, then to execute all subse¬ 
quent statements until it reaches a next state¬ 
ment. The next statement tells BASIC to In¬ 
crease the value of greet by 1 and see 
whether that value exceeds 5, the limit set by 
the /or statement. If it does not, BASIC goes 
through the loop again; when the value of 
greet exceeds the limit, the program contin¬ 
ues with the line following the next statement. 


-- ^or greet^l to 5 
20 print "Hello there* 
30 next greet 
40 print "Goodbye" 

50 end 
run 

Hello there 
Hello there 
Hello there 
Hello there 
Hello there 
Goodbye 
Ok 



You can change the variable in a /or. . . next 
loop by any amount, using a step expres¬ 
sion, as shown in line 10. Note that when the 
program is run, it uses values for the vari¬ 
able wtthat increase by 2 each time, but only 
up to 20. This is because the next step would 
increase the value of wtto 22, exceeding the 
limit of 21, so the program branches to 
the line following the next statement. 


10 


for wt=10 to 21 step 2 
20 let dzn=wttl2 
30 print "Weight =*' wt, "Weight per dozen =" dzn 
40 next wt 
50 print "Finished" 

60 end 




run 

Weight = 
Weight = 
Weight = 
Weight = 
Weight = 
Weight = 
Finished 
Ok 


10 

Weight 

per 

dozen 


120 

12 

Weight 

per 

dozen 

= 

144 

14 

Weight 

per 

dozen 

X 

166 

16 

Weight 

per 

dozen 

= 

192 

18 

Weight 

per 

dozen 


216 

20 

Wei gh*t 

per 

dozen 

= 

240 


You can set the limits of a /or. . . next 
loop using values assigned to variables with 
an /nputstatement, as shown at right. 

Each time the program runs, the starting and 
ending point of the loop are set from the 
keyboard. Note the structure of the input 
statement and of the keyboard input; 
a comma must separate the variable names 
and the keyboard entries when you as¬ 
sign values to more than one variable. 


10 input "Weight range tfro/n, to)'*; wl, w2 
20 for wt = wl to w2 
30 let d2n=wt»12 

40 print "Weight =" wt, "Weight per dozen dzn 
50 next wt 
60 print "Finished" 

70 end 


run 


Weight range (fro®, to)? 6, 9 


Weight = 
Weight = 
Weight = 
Weight = 
Finished 
Ok 


Weight per dozen 
Weight per dozen 
Weight per dozen 
Weight per dozen 


= 72 
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PROGRAMMING IN BASIC 


Storing and 
Retrieving Data 


A reac/statement instructs BASIC to es¬ 
tablish one or more variables, then to look for 
the first data statement in the program and 
assign values it finds there to the variables in 
the reoc/statement. In the short program 
at right, the read statement assigns values to 
three variables, which are then displayed 
by the pr/nf statement. Note the use of com¬ 
mas in the pr/nf statement; each tells BA¬ 
SIC to display the next listed element in the 
next screen column. These invisible col¬ 
umns are always 14 spaces wide. 



When a read statement looks at a data 
statement more than once, it moves to the 
next set of data that it has not already 
used. In the program shown at right, the read 
statement is placed in a loop that causes it 
to be repeated five times; at each repetition, 
it reads a new set of data, which is dis¬ 
played by the pr/n^ statement. A read state¬ 
ment can assign values to numeric or 
string variables; string values — in this case, 
names — do not need to be bracketed 
with quotation marks in the data statement 
unless they contain symbols that have a 
special meaning in BASIC (page 79). 



88 


Many programs process information 
that does not change from one run to 
the next. It is useful to keep this data 
permanently attached to the pro¬ 
gram. You could assign the data val¬ 
ues to variables using /e/statements, 
but this would be a cumbersome 
procedure if you had more than a 
few items. BASIC provides a much 
easier way to deal with this situa¬ 
tion; it employs a pair of statements 
called read and data. 

A read statement tells BASIC to es¬ 


tablish one or more variables, and 
then to fill them with values taken se¬ 
quentially from a data statement. The 
first read statement in a program 
draws on the first data statement, 
wherever it may appear. BASIC 
takes as many values from the data 
statement as are required to fill the 
variables of the reac/statement. BA¬ 
SIC keeps track of the values that 
have already been used, by leaving 
a pointer in the data statement; the 
next time a read statement returns to 











You can use read and data statements to 
supply values for repeated calculations, as 
shown in this program. The reoc/state¬ 
ment assigns values to variables that are then 
used in line 40 to compute other values; 
the results are displayed by the pr/n/state¬ 
ment. The zeroes at the end of the last 
cya/o statement are end-of-data markers; 
when these values are assigned to vari¬ 
ables, the //statement in line 30 directs BASIC 
to branch to the enc/statement. 


"Net '■ , "Percent " 


10 print "Year", "Income", "Expenses 
20 read year!, me, spent 
30 if yearl="0'' goto 70 

40 let net = inc-spent: let pct = 100*(net/ 1 nc) 

50 print year!, me, spent, net, pet 
60 goto 20 

70 end ^ 

80 data 1974,32578,31432,1975,29864,30123,1976,31589, 
90 data 1977,34769,33350,1978,36801,34982,1979.36544, 
100 data 1980,37297,35265,1981,38477,35802,1982,39469 
110 data 1983,41005,37456,0,0,0 



When the program shown in the screen 
above is run, all of the values from the data 
statement are displayed in a chart, along 
with some values computed using the data. 
You could add new figures for each suc¬ 
ceeding year simply by inserting new values 
into the data statements, before the mark¬ 
er zeroes that indicate the end of the data. 


^ Year 

Income 

Expenses 

Net 

Percent ^ 

1 1974 

32578 

31432 

1146 

3.517711 1 

1 1975 

29864 

30123 

-259 

-.8672649 1 

1 1976 

31589 

30215 

1374 

4.349616 1 

1977 

34769 

33350 

1419 

4.081222 

1978 

36801 

34982 

1819 

4.942801 

f 1979 

36544 

34700 

1844 

5.045972 ' 

1980 

37297 

35263 

2034 

5.453522 

1931 

38477 

35802 

2675 

6.952205 

1982 

39469 

36223 

3246 

8.224176 

1983 

41005 

37456 

3549 

8.655042 

Ok 
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the data statement, it starts with the 
first unused values. 

When BASIC comes to the end of 
a data statement and still needs val¬ 
ues to fill the variables of a read 
statement, it moves to the next data 
statement and continues to read. If it 
runs out of data before all of the 
variables are filled, BASIC stops run¬ 
ning the program and displays an er¬ 
ror message. You can avoid this 
problem by putting a special marker 
value — a zero where BASIC expects 


to find a year, for example — at the 
end of your data, and writing an if 
statement that tells BASIC what to do 
when the read statement assigns this 
value to a variable (line 30, fop 
screen, above). Another way to avoid 
an end-of-data error is to write a 
special error-trapping routine; this 
more advanced procedure is ex¬ 
plained in the IBM BASIC manual. 

You can reuse the values in a data 
statement by resetting the pointer. A 
restore statement does this job, tell¬ 


ing BASIC to move the pointer back 
to the beginning of the first data 
statement (see the program listed on 
page 94). You can also use a restore 
statement anywhere in the program 
to set the pointer to the beginning of 
a specific data statement: Simply fol¬ 
low the restore statement with the line 
number of the data statement you 
want ta start with. 
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PROGRAMMING IN BASIC 


Subroutines to Be 
Called When Needed 


This flow chart illustrates the working of the 
program shown at the bottom of the op¬ 
posite page. The subroutine for printing a box 
around a title is like a shorter program, 
and it performs the same job each time it is 
used. BASIC branches to the subroutine 
when it encounters a gosub statement; when 
it reaches a return statement, it resumes 
execution of the main program, with the 
statement that follows the gosub. 



PRINT 

1 PRINT BOX 

i^Chapter 1 

1 SIDES 



PRINT BOX 
BOnOM 


PRINT 

^Chopfer2'< 

1 

1 

RETURN 



Many programming situations re¬ 
quire that you repeat a particular set 
of steps at several different points 
within the program. Instead of writ¬ 
ing the same set of instructions sever¬ 
al times, you can write the code 
once, in a sort of miniature program 
called a subroutine, and then tell BA¬ 
SIC to branch to the subroutine each 
time you need it. 

This procedure, which is known as 
calling a subroutine, is made possi¬ 
ble by the gosub and return state¬ 
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ments. A gosub tells BASIC to branch 
to the subroutine that begins at a 
specified line, then execute all subse¬ 
quent lines until it encounters a return 
statement. The return instructs BASIC 
to branch back to the statement fol¬ 
lowing the gosub that called the sub¬ 
routine. A subroutine can be called 
any number of times, and from any¬ 
where in the program. 

All subroutines should be posi¬ 
tioned after the end statement of a 
program, to prevent BASIC from 


executing the subroutine as it pro¬ 
ceeds sequentially through the num¬ 
bered lines of the program. If BASIC 
encounters a return statement that 
does not have a preceding gosub, it 
will stop the program and display 
an error message. 





























10 


print “Hello." 

20 gosub 1000 
30 print "This progra* demonstrates subroutines 
40 gosub 1000 
50 print "It goes to the Pause' subroutine at" 
60 print "line 1000 after each message." 

70 gosub 1000 

80 print "This ends the demonstration." 

90 end 

1000 rem Pause' subroutine 
1010 for n=l TO 3000:next n 


n 


1020 print 


1030 return 


L 
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When BASIC reaches a gosub statement 
anywhere in this program, it branches to the 
subroutine at line 1000. The subroutine 
is a simple for. . . next loop that counts to 
3000, followed by a return statement that 
causes BASIC to branch back to the state¬ 
ment following the most recent gosub. 


When you run the program shown at left, BA¬ 
SIC displays the sentences in the print 
statements (below). Each sentence is fol¬ 
lowed by a blank line and a pause of 
about two seconds, both inserted by the sub¬ 
routine. Afor... nextloop is often used 
to create a pause in BASIC. To vary the 
pause length, change the final value of 
the counter in the /orstatement; it takes 
about a second for your PCjr to count to 
1250 in this type of loop. 


Hello. 

This program demonstrates subroutines. 

It goes to the 'Pause' subroutine at 
line 1000 after each message. 

This ends the demonstration. 

Ok 



'Prints headings in boxes 
15 els 

20 gosub 2000 
30 locate 2,3:print 
40 locate 5,l:gosub 
50 locate 6,3:print 
60 locate 9,l:gosub 
70 locate 10,3:print 
13,1 


"Chapter 1" 

2000 

"Chapter 2" 

2000 

"Chapter 3“ 

80 locate 
1000 end 

2000 'Subroutine to print box 

2010 let a$*chr$(210):b$»chrl(196):c$*chr$(19l) 

2020 let dl=»chr$(179) :e$*chrS(192) ;f$*chr$(2l7) 

2030 print a$;;for n=0 to 12:print b$;;next n:print c$ 

2040 print d$;:for n=0 to 12:print" ";:next n:print dl 

2050 print e$,*:for n=0 to I2:print b$;:next niprint f$ 

2060 return 


The program above uses a subroutine and 
the graphics characters of your PCjr to 
create boxes around text on the monitor 
screen. The values assigned to variables 
in lines 2010 and 2020 of the subroutine are 
ASCII codes for the graphics characters 
that will make up the boxes; these codes are 
listed in an appendix to the BASIC man¬ 
ual. Note the use of line numbering and re¬ 
marks to make the program easy to read. 



When the program at left is run (below), each 
box is drawn, then the text is printed in it. 
/.oco^e statements position the text by telling 
BASIC where to put the cursor before 
each pr/nf statement. The numbers in a locate 
statement indicate first the line, from 1 to 
25, and then the column, from 1 to 80. 
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PROGRAMMING IN BASIC 


Sound and Graphics: 
a Treasury of Effects 

A sound statement sets two values that 
control the frequency and duration of a 
sound generated by the PCjr. The val¬ 
ues may be numbers or variables, as shown 
in this program. In line 50, frequency is set 
by the variable freq, which is defined in line 
40; duration remains constant — for each 
note, 20 ticks of the PCjr's clock (text, belowj. 

In line 100, frequency remains constant 
(200 cycles per second) and duration is set by 
the variable dur (line 801. A second sound 
statement in line 100 causes a pause; BASIC 
executes frequency 32767 as silence. 


10 Deaonstrates SOUND statement 
20 play 

30 locate 13,l5:print"Frequency and duration jn the SOUND statement" 
40 for freq«100 to 400 step 20 
50 sound ^req. 20 

60 locate I5,20:prjnt"This is frequency" treq duration 20" 

70 next freq 

60 for dursl0 to 60 step 10 

90 locate 16,20:print"This is frequency 200 , duration" dur 
100 sound 200, dur: sound 32767,10 
110 next dur 
run 

Frequency and duration in the SOUND statement 


This IS frequency 400 , duration 20 
This is frequency 200 , duration 30 



This program uses two p/oy statements to 
play the long sequence of notes and pauses 
of a musical piece. Lines 20 through 90 
assign to variables the character strings that 
represent actual musical notation. In line 
120, the first element of the ploy statement 
sets the tempo of the music at 180 quarter 
notes per minute. The remaining elements in 
the p/oy statements tell BASIC to execute 
each string named after the letter x. Each of 
these elements must be followed by a 
semicolon, or BASIC will stop the program 
and signal "Syntax error." 


10 Prograa to play soaething like a Naltz 

11 ■ 

19 Assign "subtunes" to string variables 

20 A$»"o3c8.pl6ceg0.p16gp4g8p0g0p4" 

30 Bf="e8p0e8p4": C$»"f8p8f8p4" 

40 D$=*o2b8.pl6bo3da8.pl6ap4a8p8a8p4’‘ 

50 ES*’*f8p0f8p4-; F»»-e8p8e8p4- 
60 6l*''c8.p 16cego4cp4c8p8c8p4'' 

70 H5»"o3g8p8g8p4*; IS»“o3a8p8a8p4" 

80 J$-"o3d0.pl6df a8.pl6a2g*’g8..o4e2p8co3ee.da.gc. 
90 Kl="p8mscl6c8p32c. " 

100 ' 

110 Play waltz as series of subtunes 

120 PLAY''tl80;xaS;xbf;xa$;xc$;xdl;xe$;xd$:xf$; 




You can use BASIC to harness the 
considerable sound and graphics 
capabilities of the PCjr for progranns 
you create. Under the direction of 
Cartridge BASIC, the PCjr can pro¬ 
duce up to three different sounds si- 
multaneously, using its three 
"voices." Each voice can be pro¬ 
grammed with a sound or play state¬ 
ment. A sounc/statement (above, top) 
lets you define the pitch and length of 
a sound by specifying a frequency, in 
cycles per second, and a duration, 
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expressed as a number of ticks of the 
PCjr's internal clock — which ticks 
18.2 times per second. You also have 
a choice of 16 volume settings. 

Each sound statement defines only 
one tone; to write and play music, 
you can use p/ay statements. Like a 
pr/n/ statement, a p/ay statement 
processes strings of characters with¬ 
in quotation marks. But the strings in 
a p/ay statement have meaning only 
as musical notation; instead of dis¬ 
playing the characters on the moni¬ 


tor, BASIC interprets them as instruc¬ 
tions for the speaker. The strings in a 
play statement must be written ac¬ 
cording to a strict set of rules, ex¬ 
plained in IBM's BASIC manual. 

The PCjr Is every bit as versatile in 
Its visual performance as It is with 
sound. BASIC uses screen statements 
to control the display of material on a 
monitor. Screen 0 sets a mode that 
allows the display of only text and 
IBM's special character set. Within 
this mode you can use a width 40or a 











When BASIC is in text mode, as set by a 
screen 0 statement, a co/or statement controls 
the background color of the screen and 
the foreground color of the displayed charac¬ 
ters. Here, the /npu/statement on line 30 
assigns values to the variables FORE and 
BACK; the co/or statement on line 40 uses 
these values to set the colors of the message 
displayed by the pnn^ statement on line 
60. The if .. . then statement on line 50 tells 
BASIC to end the program if the normal 
color setting of 7,0 is selected. A text color 
statement accepts numbers in the range 
0 to 31 for the foreground color, and in the 
range 0 to 7 for the background. 



When BASIC is in the medium-resolution 
graphics mode, as set by a screen 1 state¬ 
ment, use the co/or statement to select 
one of 16 background colors and one of the 
two '"palettes" of three colors that can be 
displayed by the other graphics statements. 
In the program at right, two for. . . next 
loops change the variables in the color state¬ 
ment on line 40, causing BASIC to set 
each palette and background color in turn. 
The line statements on lines 50 through 70 
set coordinates for the corners of three rec¬ 
tangles, each filled with one of the three 
colors of the current palette. 



X KFM This PK'oax'AH troloX' 

lO KEY OKFrSCRFEN 
1^0 FOK TO 

130 FOR FA 1^0 TO i 
COtOK BACK, FAh 
550 LINE 

560 LINE VVtiKiUBE 

70 LINE CIBO, t46> 

:B0 locate 16,3i>;FKrNT'’C«ltJV' l*^* 

5?0 LOCATE tB,2*»:FKINt‘'Cwlox' S*' 

(100 LOCATE 

110 LOCATE 22, 2:FRINT'*BACk9Vt?viaA color’* 
! BACK 

;120 LOCATE 23, A:PRINT’'FAlotti* iuiHlicr”FA 

130 FOK N=:l TO 2000:NEXT N 'Colors 
140 NEXT PAL, h 

;150 NEXT BACK C«IW 2 : 

; rua ■iPMpHM||Bi f 


Bivc><<?round color 8 
F;xlotto nuHBor O 


.wgitgrati 


width 80 statement to set the number 
of columns (40 or 80). When you use 
a color statement in text mode, you 
can draw from 16 colors for the char- 
acters, the background and the 
screen border. 

Two graphics modes allow you to 
use BASIC's sophisticated graphics 
statements. The medium-resolution 
graphics mode, set by a screen 1 
statement, also lets you use any four 
of the 16 available colors in each 
screen you create. Screen 2 sets the 


high-resolution graphics mode. In 
this mode you can use all of the 
graphics statements, such as line, 
draw and circle, but not the color 
statement; all shapes, lines and text 
appear as white on black. Text is dis¬ 
played In 40-column width in the 
medium-resolution mode; in the 
high-resolution mode, text is in 80- 
column width. Four more screen 
statements, available only in Car¬ 
tridge BASIC, provide a greater col¬ 
or choice in the graphics modes. 


There are many subtleties to the 
use of the sound, color and graphics 
capabilities of your PCjr, only hinted 
at by the examples above. If you use 
the explanations in the IBM BASIC 
manual as guides, you will find that 
BASIC can put a new world of sight 
and sound at your fingertips. 
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PROGRAMMING IN BASIC 


Writing Your Own Programs 


The program listed at right permits users 
who have typed in a secret code number to 
read financial data for selected years. The 
body of the program (orange) sets up screen 
widths and colors, and directs the overall 
flow of the program. The subroutines (yellow), 
which follow the end statement, do the 
work of taking input, reading data, comput¬ 
ing information and displaying messages. 

The data the program uses (green) follows 
the subroutines. Note the restore state¬ 
ment in line 3010, which sets the data pointer 
(page 89) to the beginning of the first data 
statement each time the subroutine uses the 
data. To use this program, you must first 
enter a three-digit code number, controlled 
by the //statement on line 4020. 


10 CUt:KfY ~ 

20 LOCATE S^lSrPRINT-WELCOME" 

30 LOCATE 9,9:PRINT"to the Short Report" 

40 LET T=3000;BOSUB 2000 

50 SCREEN 0,1jWIDTH 80:COLOR 0,7:CLS 

60 60SUB 4000 

70 60SUB 1000 ; 

80 COLOR 7,0;CLS:LOCATE 5,10:PRINT''Program ends after 10 entries." 

9? fM0: -____- 

1000 ' Subroutine for input of year desired 

1005 FOR ENTRY=1 TO 10:CLS:COLOR 0,7!LOCATE 5,10 

1010 INPUT "What year for your report (or 0 to stop)";YEARI 

1020 IF YEAR$="0" THEN END ELSE GOSUB 3000 

1025 LOCATE 20,10;COLOR 5,7 

1030 INPUT"Prftt RETURN to continut... " ,A$ 

1035 NEXT ENTRY 
1040 RETURN 

2000 ' Subroutine for timer 

2010 FOR COUNT=0 TO T:NEXT C0UNT;RETURN 

3000 ‘ Subroutine to calculate and display values 

3010 RESTORE 

3020 READ Y1I,INC,SPENT:IF YU="0" THEN GOSUB 5000:RETURN 

3030 IF YllOYEARi GOTO 3020 

3040 LET NET=INC-SPENT: LET PCT=100#(NET/INC) 

3045 CLSrLOCATE 5,3 

3050 PRINT "Report of ";DATEI;" for user" ;C0DE; "at ";TiriE$ 

3060 LOCATE 8,3:PRINT "YearIncome","Expenses","Net I", "Percent" 

3070 IF NET<0 THEN COLOR 4,7 ELSE COLOR 1,7 
3080 LOCATE 10,3:PRINT YU, INC, SPENT, NET, PCT 
3090 COLOR 0,7:RETURN 

4000 ' Subroutine to establish user identity 

4010 LOCATE 5,10;INPUT "Please enter your secret code: ",C0DE 

4020 IF C0DE>127 OR C0DE<125 THEN PRINT"Sorry, you are not authorizedEND 

4030 RETURN 

5000 ' Subroutine for no data 

5010 COLOR 7,0;LOCATE 7,10:PRINT " No data for year ";YEAR$;" " 

5020 LET T=1500:GOSUB 2000;RETURN 

7000 DATA 1974,32578,31432,1975,29864,30123,1976,31589,30215 
7010 DATA 1977,34769,33350,1978,36801,34982,1979,36544,34800 
7020 DATA 1980,37297,35263,1981,38477,35802, 1982,39469,36223 
7030 DATA 1983 ,41005,37456 

9999 DATA 0,0,0 I'This marker stops the search. 


The best way to write a BASIC pro¬ 
gram is one piece at o time. First de¬ 
fine the jobs that need to be done 
within the program, then write the 
subroutines, loops and lists of state¬ 
ments to do each of the jobs. This 
way you can test and correct each 
part of the program independently 
before all the pieces are together; 
you will have far less trouble finding 
the bugs in a short segment than in 
an entire program that may be hun¬ 
dreds of lines long. 
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Building a program In segments 
also helps you keep a logical pro¬ 
gram flow, which is easier to under¬ 
stand. And if each part is largely self- 
contained, you can more easily 
modify a part of the program without 
affecting the rest. 

With the elements of BASIC you 
have learned in this chapter, you can 
begin writing programs on your own. 
Keep in mind, however, that you 
have only scratched the surface. 
There are more than 100 commands 


and statements in the syntax of Car¬ 
tridge BASIC, each designed to do a 
specialized job. It takes time to be¬ 
come familiar with the language and 
all that it can do for you. You can 
learn a great deal by reading other 
people's programs, trying to follow 
the flow of control and determine the 
outcome of the processes. However, 
the best way to master BASIC Is by 
writing programs of your own, trying 
out new ways of doing things. Prac¬ 
tice makes programmers. 










The first screen displayed by the program 
is controlled by the screen, width, color, locate 
and print statements in lines 10 through 
30. It remains on the screen while the pro¬ 
gram branches from line 40 to the timer 
subroutine at line 2000. BASIC then returns to 
line 50, where new screen, width and color 
statements establish the initial settings for the 
next subroutine. Line 60 branches the pro¬ 
gram to the user-identity subroutine at line 
4000; when that is completed, BASIC re¬ 
turns to line 70 and immediately branches to 
the input subroutine at line 1000. 



The input subroutine first displays the mes¬ 
sage shown at the top of this screen. If your 
selection is 0, the program ends. Other¬ 
wise BASIC branches to the subroutine at line 
3000, which reads, calculates and dis¬ 
plays data. If there is no data for the selected 
year, BASIC branches to the subroutine at 
line 5000, which prints the ''no data" mes¬ 
sage. When BASIC returns to the point 
where it left the input subroutine, the "contin¬ 
ue" message is displayed; when you 
press the Enter key, BASIC goes back to the 
beginning of the subroutine for another 
passthrough the for. . . next\oop. 



If the program has data for the year you 
select, the subroutine at line 3000 puts to¬ 
gether a report similar to the one shown 
at right. Note that the date and time, inserted 
by line 3050, are correct only if you en¬ 
tered the correct date and time when you 
booted your PCjr (page 33). 

The input subroutine repeats itself 10 times, 
allowing you 10 entries before program 
control returns to line 80, which prints a final 
message before the program ends. 
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Appendix 


DOS Error Messages 


Errors are a hazard in almost any process; working with 
computers is no exception. Sometimes the problem is with 
the hardware, sometimes it lies in the software — and very 
often it is caused by a misunderstanding between you 
and the equipment, soft or hard. For example. If you un¬ 
knowingly slip out of your word processing program and 
into DOS and then type a command to the word proces¬ 
sor, DOS will respond. Bad command or filename. 
Thus, the first thing to do is determine whether an error 
message Is coming from the application program, from 
BASIC or from DOS. 

This chart covers a few of the error messages most 
frequently issued by DOS. If you are in BASIC, you 
should refer to the IBM BASIC manual; if you are us¬ 
ing an application program, you will have to refer to 
its own documentation. 


ATTEMPTED WRITE-PROTECT VIOLATION 

signals that the disk you are trying to format has its write- 
protect notch covered. Do not remove the tab until you 
have thought about why you put it there in the first place; 
you may destroy important data. 

BAD COMMAND OR FILENAME 

indicates one of two things: either that the command you 
have entered is not a valid DOS command or that DOS 
could not find the file you named, when it searched the 
disk in the drive. (File not found is a related message.) 
Check your spelling, of both the command and the file¬ 
name; also check your disk directory. 

COMPARE ERROR(S) ON TRACK XX, SIDE XX 

occurs when you use the command diskcomp to try to 
compare two disks that are not identical. If you copy files 
from one disk to another using the copy command, all 
the information is transferred, but it is not stored in the 
same tracks on the target disk as it was on the source disk. 
This causes discrepancies when the disks are compared 
track for track. If you want to make an exact copy of a 
disk, use the diskcopy command. 
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DATA ERROR READING DRIVE A: 

ABORT, RETRY, IGNORE? 

often means a disk has a defective spot. Enter r for retry. If 
this does not correct the error, abort the program and 
remove the disk. Note: The ignore response is not recom¬ 
mended, because it will destroy data. If you decide to 
reformat the disk, be sure to copy files first. 

DISK BOOT FAILURE 

may mean the disk drive door is open, or that the disk is 
wrong side up. If neither is the case, copy the files from the 
failed disk to a new one and boot from the new one. 

FORMAT FAILURE 

and related messages such as Unable to write boot 
or Unrecoverable format error on target may 

arise with the format, diskcopy or system com¬ 
mands. If the problem is the target disk, discard it and use 
another; if It is the source disk, copy all tiles and then 
reformat the disk. (Note: Consistent problems with disks 
you have formatted may indicate a disk-drive hardware 
problem and should be reported to your service center.) 

INSERT COMMAND.COM DISK IN DRIVE A: 

AND STRIKE ANY KEY WHEN READY 

may occur when DOS Is trying to reload the command 
processor but cannot find it on the disk in the drive. Insert 
a DOS disk and press any key. A related message — 

Invalid command.com in drive a: — means that 
the command.com on the disk is not the right version. 

NON-DOS DISK 

signals that the file allocation table does not contain valid 
information. Run chl<dsl<\o see If the problem can be cor¬ 
rected. If not, the disk probably needs to be reformatted, 
but try to copy important files first. 

NON-SYSTEM DISK OR DISK ERROR 
REPLACE AND STRIKE ANY KEY WHEN READY 

means there is no entry for ibmbio.com or ibmdos.com In 
the directory, or that the disk drive had trouble with the 
disk when you booted up. Insert a DOS disk and reboot. 







Taking Care of Your System 


ENVIRONMENTAL PROTECTION 

Keep all food and liquids away fronn the connputer, 
and do not smoke in the same room with the machine. 

Place the computer at least three feet away from 
vents, air conditioners and radiators, and six feet 
away from space heaters. 

Do not place the computer in direct sunlight; the heat 
could overwhelm the machine's cooling system. 

Keep the computer from three to six feet away from 
telephones, tape recorders and other devices that 
can generate magnetic fields; the fields can interfere 
with the disk drives, memory circuits and disks. If nec¬ 
essary, shield the computer from these devices with a 
metal bookcase or file cabinet. For the same reason, 
keep objects that can become magnetized, such as 
car keys and paper clips, at a safe distance from the 
machine and the disks. 

To keep static electricity to a minimum, try to maintain 
humidity at 50 per cent or higher; use antistatic sprays 
and floor mats. 

Avoid using auxiliary heating devices — especially 
kerosene heaters and wood stoves — in the same 
room with the computer. These heaters generate pol¬ 
lutants that can leave a film of kerosene, ash and dust 
on and in the machine. 

Clean the system components and work area weekly. 
Use a vacuum cleaner, or wipe down the exterior of 
the machine with a soft, damp cloth. You may also 
use special products made for cleaning electronic 
equipment: lint-free cloths, pressurized air cannisters, 
screen-cleaning solutions. 

Do not try to clean inside the system unit or the disk 
drives; close disk-drive doors to keep out dust. 

Never use detergents, chemical solvents or all¬ 
purpose sprays to clean the components. These 
leave damaging residues, which can cloud the screen 
surface and remove its antiglare coating. 


POWER PROTECTION 

Connect the computer to a separate circuit if possi¬ 
ble, and use a surge protector to guard against volt¬ 
age spikes. Avoid outlets on the same circuit with 
large appliances such as refrigerators. 

Make sure every component of the system is properly 
grounded with three-pronged plugs. Do not cut or 
bend the third prong, or use two-prong adapters; this 
defeats the purpose of the ground. 

Keep all cables out of the way so they will not be 
stepped on, tripped over or pulled loose during 
a work session. 

DISK PROTECTION 

If possible, make backup copies of program disks 
before using them for the first time, and then work with 
the backups instead of the masters. Also back up 
important data disks frequently. Label and date the 
backup disk, and store it in a different place from 
the original. Metal file cabinets make good storage 
places for disks. 

Always use a felt-tip pen to write on disk labels; pen¬ 
cils or ballpoints will damage the disk's surface and 
interfere with information stored there. 

Store disks vertically or horizontally, but do not stack 
them more than 10 deep and do not bend them or 
crowd them into a container. 

Never touch any exposed surface of the disk; skin oils 
will damage the surface, and any attempt at cleaning 
will only cause more damage. 

Periodically inspect the center hole of the disk; if It is 
damaged, the disk should be replaced. Also inspect 
the surface area that is visible through the head slot. 
Shiny rings, scratches or folds are signs the disk 
should be replaced. 

Use corrugated cardboard to mall floppy disks; regu¬ 
lar cardboard Is not stiff enough. Special mailers are 
also available from computer supply firms. 
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APPENDIX 


Upgrading 
an Entry-level 
System Unit 


The first device you will want to odd to 
your entry-model PCjr is on IBM Disk Drive. 
Before you moke any connections, turn 
the computer's power switch off, disconnect 
the power cable and let the computer 
cool for five minutes. Then remove the cover 
from the system unit (page 68). Unpack 
the disk drive unit, its two unattached cables, 
and the disk-drive adapter board. Plug 
one end of the black disk-drive power cable 
into the white connector on the back of 
the drive unit. Then connect the numbered 
end of the wide gray signal cable to its 
connector on the disk drive (right). 



To install the disk drive, first snap out the 
plastic disk face plate from the inside of the 
front panel of your PCjr. With the front of 
the computer facing you, angle the disk drive 
unit into place as shown at right, holding 
the black disk-drive power cable and the red- 
and-blue fan power cable so that they run 
under the drive unit and emerge on the other 
side. Position the disk drive in the comput¬ 
er's front panel, and align the white mounting 
pins on the bottom of the drive with the 
white holes in the system unit. Press the disk 
drive down until it snaps into place. 
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Bring the power cables for the disk drive 
and the fan across the bottom of the system 
unit, toward the power board on the left 
side; take core to keep both cables flat. Plug 
the red-and-blue fan power cable into the 
lower of the two white connectors on the right 
edge of the power board. Then plug the 
black disk-drive power cable into the upper 
white connector Iright). 



Find the disk-drive adapter board that is 
packaged along with the drive unit. Plug the 
tree end of the gray signal cable into the 
connector on the top left side of the board. 
With both hands, lower the adapter 
board's connector into the first slot beside the 
drive unit, as shown at right. Make certain 
that the left side of the adapter board slides 
into the first of the two plastic guides lo¬ 
cated along the side of the system unit. 



A further enhancement for the PCjr is a 
64KB Memory and Display Expansion Op¬ 
tion, which adds the extra memory re¬ 
quired to run many of the programs available 
for the PCjr. Guide the connector of the 
memory expansion board, encased in its pro¬ 
tective metal holder. Into the slot beside 
the power board Iright). 

Now you may replace the cover of the 
system unit. Before running any programs, 
check the disk drive by running the inter¬ 
nal diagnostic tests contained in the PCjr's 
memory (pages 24-25). 
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Quad, Acorn Software. 51: Casino Games, 
IBM — Adventures in Serenia, Sierra-on-Line 
and IBM — Trains^”, Spinnaker Software 
Corp. 56: Facemaker^“, Spinnaker Software 
Corp. — Delta Drawing^” Learning Program, 
Spinnaker Software Corp. 57: PC Design, Ko¬ 
ala Technologies Corporation. 61: Home- 
word, Sierra-on-Line and IBM. 63: PFS:File, 
Software Publishing Corporation and IBM. 
65: VisiCalc 1.1, IBM. 71: PCjr Sampler, IBM. 
72, 73: CompuServe Information Service. 76: 
Cartridge BASIC, IBM. 
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Index with Glossary 


Numerals in italics indicate an illustration 
of the subject mentioned. 

Adapter: card, for modem, 68; color/ 
graphics monitor, 93 
Address: a storage location in memory. It 
con hold numeric or alphabetic data or 
a program instruction. 

Application programs, 31; business 
graphics, 59; data base management, 
59,62-63; loading, 32; self-loading 
disk, 31,43,47,59; spreadsheet, 59, 
64-65; word processing, 59,60-61 
Artificial intelligence, 53 
ASCII code, 25,91 

g Backup: a duplicate copy of stored infor¬ 
mation on a disk; 39,47,97 
BASIC, 21,22,31,53; Cartridge, 21,26- 
29,76-77; Cassette, 26-27, 76; com¬ 
mands, 78-79; compiler, 75; equal sign 
in, 82,84; error messages, 96; function 
keys, 76; graphics programming, 92- 
93; loops, 86-87,88,91; mathematical 
computations, 79, 82-83; programming 
in, 75-95; programming mode, 76, 77; 
sound programming, 92-93; source 
code, 75, 86; statements, 79; subrou¬ 
tines, 90-91,94,95; variables, 80-83 
Baud rate, 70 

Block: o sector of disk storage that holds 
512 characters. 

Booting: the process of putting a program 
in control of the computer, also colled 
system reset; 32,33 
Bug: o software error in a program; 94 
Bulletin board (electronic), 67 
Bus: o set of electrical wires inside the sys¬ 
tem unit, connecting the computer's 
components. 

Byte, 11,22. See also Useful Terms 

^ Cables, 11, 12, 18, /9; adapter, for RGB 
monitor, 14; for disk drive, 98, 99; link¬ 
ing keyboard to system unit with, 13; 
printer, 17 

Cartridges, 3,11; inserting, 28. See also 
Useful Terms 

Cassette recorder, 11,26 
Cassette tape, 10,26 
Chip: o miniaturized electronic circuit on 
a silicon flake Vis" to Ya"square. 

C/s command, 78, 79 
Color: capabilities, 21; in Cartridge BA¬ 
SIC, 29; in Cassette BASIC, 27; pro¬ 
gramming, 93 
Co/or statement, 93 

Communications: between computers, 

67,70, 71; installing modem, 68-69; 
with mainframe, 67, 70; program, 70, 


71; subscribing to information service, 
67,72-73 

Components: adapters for optional 
equipment, 9; care of, 97; connecting, 

/ 1, 12-19; diagnostic tests, 24-25; 
entry-level system, 11, /S; expanded 
system, 9, 11, 19; placement, 97; set¬ 
ting up, 9 

CompuServe, 72, 73 
Controller, for games, 50 
CPU (central processing unit), 10, 12 
Cursor: a flashing marker on a monitor 
screen, showing where the next charac¬ 
ter will be displayed; 2 1 

Q Data. See Useful Terms 

Data base: a large file of information on 
a single subject or related subjects. A 
data base is continually updated and is 
organized for easy access; 62, 67 
Data base management, programs, 59, 
62-63 

Device name, 38,39 
Diagnostic routines, 21,24-25 
Directory: a list, or table of contents, of 
programs or data files stored on a 
disk. Displaying, 34-35 
Diskdrive, 10, 11, 19,26; adding to 
entry-level machine, 98-99; DOS and, 
32,33 

DOS, 31,32-33; backup copy, 39; boot¬ 
ing, 32,33; commands for handling 
files, 42-43; copying files, 38-39,40; 
copying files from keyboard, 41; copy¬ 
ing programs, 32; formatting disk, 36- 
37; locating files, 34-35; making a pro¬ 
gram self-loading, 43,47; naming files, 
35; storing files, 34 

g Educational software, 45,46-49; choos¬ 
ing, 45,46,48,49; graphics software, 
56; monitor for, 48; programming in 
Logo, 52-55 

Electrical precautions, 19,97 
Electronic mail, 67, 73 
Enc/statement, 79, 90 
Entertainment. 5ee Games 
Entry-level model, 2,11, 18; adding ac¬ 
cessories, 98-99 
Error messages, 96 
Expanded system, 2,9, 11, 19 
Expansion board, 10,59; adding to entry- 
level machine, 99 
Expansion slot, 68,69 

p Files: changing name, 43; copying on 
disks, 38-39,40; copying from key¬ 
board, 41; displaying, 43; DOS com¬ 
mands, 42-43; formatting new disk, 36- 
37; locating, 34-35,37; naming, 34,35; 


storing on disks, 34,36; storing infor¬ 
mation on disks (data base manage¬ 
ment), 62-63. See also Useful Terms 
Filespec, 35,38,39 

Floppy disks, 3, 10; care of, 36,97; copy¬ 
ing files, 38-39,40; formatting new, 36- 
37; loading, 78; naming files, 34,35; 
program, 31; storing files on, 34; storing 
program on, 78. See also Useful Terms 
Flow chart, 86, 90 

For. . . next statement, 79,86-87,91,93; 
chart 79 

Format: a magnetic pattern recorded on a 
disk to organize it by track and sector, 
for easy storage and retrieval of files; 
36,37,47 
Formatting, 36-37 

Q Games: joystick, 3, 50; role of, 45; soft¬ 
ware, 45,50-51 
Gosub statement, 79,90,91 
Goto statement, 79,84,85 
Graphics: business, 59; capabilities, 21, 
27; in Cartridge BASIC, 28,29, 76; in 
Cassette BASIC, 27; characters, 91; 
drawing with touch pad, 57; program¬ 
ming, 92-93; software, 56; statements, 
93 

PI Hardcopy: paper copy of any computer 
output, including programs or data, 
made by a printer or plotter connected 
to a computer; 27 

Hardware, 31. See also Components; 
Useful Terms 

Home office, 59; setup, 19 

I If. .. then statement, 79,84-85,89,93 
Immediate (command) mode, 77, 78 
Information services: subscribing to, 67, 
72-73; utilities, 73 
Infrared transmission, 12, 13 ,18 
Input, 12, 13,32. See also Useful Terms 
Input device, 31,39 
Input/output slots, / / 

/npuf statement, 79,80,81,82, 87,93 
Integrated software, 59 
Interface: a device that translates signals 
between two computers or accessories 
to send or receive data accurately; 17 
Interpreter: a computer language that, 
each time a program is executed, 
translates each statement in it into a 
form the machine can perform directly; 
7S, 76, 77, 78,79 

J Joystick, 3, 18,27; discrete, 50; for 
games, 50; proportional, 50 

K Keyboard, 5, 12; BASIC function keys. 
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76; cable for linking to system unit, 12, 
/3; infrared transmission, 12, 13, 18; 
setting up, 18, /9; special keys, 21,22, 
chart23; tutorial, 21,23 

L Language: on organized set of instruc¬ 
tions used to communicate with a com¬ 
puter. Low-level languages, such os as¬ 
sembly language, use the computer's 
built-in machine language. High-level 
languages, such os BASIC, Logo, 
COBOL and Pascal, use English-like 
commands, which a compiler or inter¬ 
preter must translate before or during 
use; 21,53. BASIC, 26-29,75, 76, 77; 
built-in, 22; compiled, 75; interpretive, 
75; Logo, 52,53 
Let statement, 79,82-83 
Light pen: a light-sensitive pointer whose 
position on the monitor screen con be 
read by the computer with the appro¬ 
priate software; 27 
List command, 76, 78, 79 
Looc/command, 76, 78, 79 
Locote statement, 79,91 
Logo, 49,52-55 
Loops, 86-87,88,91,93 

M Memory, 10, 11,22; adding more with ex¬ 
pansion board, 59, 99. See also Useful 
Terms 

Menu: a screen display listing program 
options, each identified by a number or 
letter. The user selects the desired op¬ 
tion by pressing the appropriate num¬ 
ber or letter key. 

Modem: a telephone interface that con¬ 
verts a computer's digital signals to sig¬ 
nals that con be sent over phone lines. 
There are acoustic and direct-connect 
modems; 26. Acoustic, 69; direct- 
connect, 69; external, 68, 69; internal, 
68-69 

Monitor: cable for, 14; color/graphics 
adapter, 93; composite video, 4, 14, 

48; connecting, /4; for educational 
programs, 48; 80-column display, 62; 
and graphics, 14; RGB, /4; setting up, 
18, /9; and word processing, 14 
Music: capabilities, 21; in Cartridge BA¬ 
SIC, 28, 29, 76; in Cassette BASIC, 26; 
programming, 92 

^ Network: a method of connecting several 
computers to shore common accesso¬ 
ries and/or data. See Communications 
New command, 78, 79 

Q Operating system, 31. See also DOS; 
Useful Terms 


Outlet bar (box), 18, 19,22 
Output. See Useful Terms 
Output device, 31,39 

p Parallel printer adapter, 17 

Peripheral: on accessory connected to a 
computer; 2 

Pixel: one graphic point (a picture ele¬ 
ment) on the video display. 

P/oy statement, 92 

Plotter: a computer-controllable drawing 
device that creates pictures or graphs 
on paper. 

Port: o connector in a computer, through 
which input and output data posses to 
or from a peripheral; 16, ]7, 68,69 
Power supply. See Transformer 
Printer: an accessory that produces a pa¬ 
per copy of computer output. Daisy¬ 
wheel printers produce full-formed 
characters; dot-matrix printers make 
characters from patterns of dots; 3,27. 
Adapter for other models, 17; connect¬ 
ing, 16, 17; daisy-wheel, 17; dot¬ 
matrix, 17; inserting paper, /6; letter- 
quality, 17; setting up, 18, 19 
Pr/nf statement, 26, 79, 80,81,88,89,93 
Program, 22,31; communications, 70, 71; 
incompatible, 42; loading into memory, 
78; storing on disk, 78; writing sample, 
94-95. See also Useful Terms 
Programming: in BASIC, 75-95; branch¬ 
ing a program, 84-85; correcting errors, 
78-79; flow-chart, 86, 90; graphics, 92- 
93; in Logo, 52-55; loops, 86-87; ma¬ 
nipulating variables, 80-81; mode, 76, 
77,78; simple commands, 78-79; 
sound, 92; subroutines, 90-91,94,95 

1^ RAM (random access memory], 10. See 
o/so Read-and-write memory; Useful 
Terms 

Read: a computer operation to bring in¬ 
formation into memory from a storage 
device ora keyboard; 1 0 , 32 
Read-and-write memory, 10, 11,27, 76 
Peoc//c/ofo statement, 79, 88-89 
Restore statement, 89 
PeNrn statement, 79,90,91 
RF modulator, 14, 18 

ROM (read-only memory), 10,11,21,26, 
27,76. See also Useful Terms 
Run command, 76, 77, 78, 79 

5 Sove command, 76, 78, 79 
Screen statement, 92-93 
Software, 31; application programs, 59- 
65; educational, 45,46-49; games, 50- 
51; graphics, 56; integrated, 59; Logo, 
52-55. See also Useful Terms 


Sound: capabilities, 21; in Cartridge BA¬ 
SIC, 28,29; in Cassette BASIC, 26; pro¬ 
gramming, 92; statement, 92 
Source, The, 72, 73 
Source code, 75,86 
Spreadsheet: a program for financial 
planning, income tax preparation, 
budgets or other functions based on 
equations. It appears to the user os an 
accountant's spreadsheet. Programs, 

59,64-65 

Static electricity, 9,97 
String: any group of alphanumeric char¬ 
acters stored in computer memory and 
handled as a unit; 92. Variables, 80, 81, 

82.83.88 

Subroutines, 90-91,94,95 
Syntax: the correct grammatical form for 
computer instructions; 78 
Syntax error, 22, 76, 78-79 
System unit, 5, 10; enhanced, 9, 10,]], 

19; entry-level, 2,11, 18; linking to key¬ 
board, 12, /S; setting up, 18, 19 

y Television: connecting to PCjr, 15; as 
monitor, 4,14; RF modulator, 14; set¬ 
ting up, 18 

Thermal paper, 3, 16, 17 
Toggle. See Useful Terms 
Touch pad, 57 

Transformer, 5, 10, 11, 18, /9; connect¬ 
ing, II 

Turtle graphics, 52-53. See also Logo 
Tutorial: educational software, 46,48,49; 
Keyboard Adventures, 21,23; SAT, 49 

\J Useful Terms, inside front cover 

Utility program: a computer program that ^ 
helps the programmer carry out fre¬ 
quently performed tasks, such as scan¬ 
ning a disk directory, making copies of 
disks or formatting new disks. 

V Variables, 80-83,84,86,87,88,89,92, 
93; numeric, 80,81,82,88; string, 80, 

81.82.83.88 

w Word processor: a program used in com¬ 
posing, editing, storing or duplicating 
letters or other text pieces. Also, the 
hardware used to carry out these activi¬ 
ties. Monitor, 14; printer, 77; program, 
36-37; software, 59,60-61 
Write: a computer operation to copy in¬ 
formation to a storage or display de¬ 
vice from computer memory; 1 0 , 32 
Write-protect notch: a safety notch in a 
disk or cassette that, when covered, 
prevents erasure of important informa¬ 
tion; 36 
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